<div dir="ltr"><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, Sep 11, 2021 at 5:40 AM Carl Schwan <<a href="mailto:carl@carlschwan.eu">carl@carlschwan.eu</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Le vendredi 10 septembre 2021 à 7:23 PM, Frederik Schwarzer <<a href="mailto:schwarzer@kde.org" target="_blank">schwarzer@kde.org</a>> a écrit :<br>
<br>
> Hi,<br>
<br>
Hi :D<br></blockquote><div><br></div><div>Hey Carl,</div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
> we have been working on getting KApiDox to run on Jenkins. This work has<br>
> been taken way longer than I expected but has now reached a state close<br>
> to finished. :)<br>
><br>
> So I would like to invite you to check <a href="https://api-dev.kde.org/" rel="noreferrer" target="_blank">https://api-dev.kde.org/</a> for any<br>
> show stoppers.<br>
<br>
Great work :D<br>
<br>
I see on an issue that I would qualify as blocking and it's the lack of the<br>
ECM generated doc: <a href="https://api-dev.kde.org/ecm" rel="noreferrer" target="_blank">https://api-dev.kde.org/ecm</a>. We are also losing the<br>
kube/sink doc (located at <a href="http://api.kde.org/doc/sink" rel="noreferrer" target="_blank">api.kde.org/doc/sink</a>) but it's also available<br>
in readthedocs and ihmo it should be in Doxygen format.<br></blockquote><div><br></div><div>My understanding is that ECM uses something other than Doxygen for generating it's API Documentation, which is why it is absent.</div><div><br></div><div>Would anyone on the list know if it is possible to get this process to use Doxygen, or if we need to put in place a mechanism explicitly for ECM?</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
We also are losing the krita/kmymoney/other app private api generation,<br>
but that maybe can be generated in another ci pipeline later. Not sure how<br>
much thses apps' developers are using it.<br></blockquote><div><br></div><div>This can likely be rectified if needed by including them within <a href="https://invent.kde.org/sysadmin/binary-factory-tooling/-/blob/master/apidocs/repos-to-process">https://invent.kde.org/sysadmin/binary-factory-tooling/-/blob/master/apidocs/repos-to-process</a></div><div><br> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
On the upside, I see that mauikit doc is finally correctly generated using<br>
qdoc. Yeah \o/<br></blockquote><div><br></div><div>Yes, the new setup allows us to provide this now - and being Docker image based for the generation phase should make future updates easier as well as needed.</div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
Cheers,<br>
Carl<br></blockquote><div><br></div><div>Thanks,</div><div>Ben</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
><br>
> Known issues (not show stoppers):<br>
><br>
> -   For now the Maintainers field defaults to "KDE Developers" for<br>
>     potential GDPR violation reasons, which needs to be figured out later.<br>
> -   Some modules contain formatting issues regarding markdown code blocks.<br>
>     These are also there in the current system and need to be checked at<br>
>     some point.<br>
> -   The "Older versions" links are broken. Since those docs are not<br>
>     generated anymore, we need to figure out a way to have them available<br>
>     statically.<br>
><br>
>     If we do not see any bigger issues, I would like to go live with the new<br>
>     system in a week or two.<br>
><br>
>     Thanks for your help.<br>
><br>
>     CHeers,<br>
>     Frederik<br>
</blockquote></div></div>