<div dir="ltr"><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sun, Sep 12, 2021 at 7:07 AM Frederik Schwarzer <<a href="mailto:schwarzer@kde.org">schwarzer@kde.org</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">Hi,<br></blockquote><div><br></div><div>Hi all,</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 9/10/21 21:17, Ben Cooksley wrote:<br>
> On Sat, Sep 11, 2021 at 5:40 AM Carl Schwan <<a href="mailto:carl@carlschwan.eu" target="_blank">carl@carlschwan.eu</a>> wrote:<br>
<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>
>><br>
> <br>
> This can likely be rectified if needed by including them within<br>
> <a href="https://invent.kde.org/sysadmin/binary-factory-tooling/-/blob/master/apidocs/repos-to-process" rel="noreferrer" target="_blank">https://invent.kde.org/sysadmin/binary-factory-tooling/-/blob/master/apidocs/repos-to-process</a><br>
<br>
So, we would need to decide whether we want to have applications that <br>
only have private APIs documented?<br></blockquote><div><br></div><div>That is correct.</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>
Where do we draw the line currently?<br></blockquote><div><br></div><div>To date we've not really drawn a line anywhere, but in general I think it would be best for us to only include API Documentation for projects that people can actually use externally of the project itself.</div><div>(so for Applications, they would need to provide a plugin interface, or a library that lets people reuse components of it)</div><div><br></div><div>Otherwise people might be confused as to what they're looking at.<br></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>
In general I would say, just generate everything that has a Doxyfile ... <br>
but there might be good reasons against that regarding processing power?<br></blockquote><div><br></div><div>In the past that has meant that build runs of API Documentation took several hours.</div><div><br></div><div>I'd also recommend taking a look at it from a maintainability point of view as this is something that will continue to run for some time, so we need to ensure that if projects do have special requirements that they do not create issues from that perspective.<br></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>
Frederik<br></blockquote><div><br></div><div>Cheers,</div><div>Ben<br></div></div></div>