<div dir="ltr"><div dir="ltr">I'd recommend Julie's lighting talk from 2018 LLVM Developers’ Meeting: “<a href="https://www.youtube.com/watch?v=bTzvPhKN0YI">clang-doc: an elegant generator for more civilized documentation</a>” to learn more about the tool.<div><br></div><div>We have a bot that continuously builds and publishes HTML documentation generated from Fuchsia's codebase to <a href="https://fuchsia-docs.firebaseapp.com/cpp/">fuchsia-docs.firebaseapp.com/cpp/</a> to ensure that the tool keeps working. The tools itself has been stable and performant. However, if you open that site, you'll probably notice that the generated output needs some work (try <a href="https://fuchsia-docs.firebaseapp.com/cpp/zx/index.html">https://fuchsia-docs.firebaseapp.com/cpp/zx/index.html</a> to see a more concrete example).</div><div><br></div><div>What we really need is someone with HTML, JS and CSS experience. For example, the navigation is currently loaded synchronously and always rendered in its entirety which is a problem for larger projects, which is why the page load takes so long for the link I gave above. The content itself also lacks any styling. Unfortunately, we don't have that experience on our team and we could really use some help here.</div><div><br></div><div>I'm happy to review clang-doc changes if this is something you'd be interested in contributing to.</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Aug 21, 2020 at 10:48 PM Anshil Gandhi via cfe-dev <<a href="mailto:cfe-dev@lists.llvm.org">cfe-dev@lists.llvm.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"><div dir="ltr">Thanks, I'll check it out. <br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Aug 21, 2020 at 11:43 PM David Blaikie <<a href="mailto:dblaikie@gmail.com" target="_blank">dblaikie@gmail.com</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">Seems there might already be one under the clang umbrella:<br>
<a href="https://clang.llvm.org/extra/clang-doc.html" rel="noreferrer" target="_blank">https://clang.llvm.org/extra/clang-doc.html</a> - but I'm not sure how old<br>
it is and whether it's being actively developed.<br>
<br>
On Fri, Aug 21, 2020 at 10:34 PM Anshil Gandhi via cfe-dev<br>
<<a href="mailto:cfe-dev@lists.llvm.org" target="_blank">cfe-dev@lists.llvm.org</a>> wrote:<br>
><br>
> Hi team clang,<br>
><br>
> I am interested in developing a tool to generate code documentation.  So I am wondering if this project already exists and I could collaborate with you. If not, I can start this project and I would still love to collaborate with anyone who's interested.<br>
><br>
> Kindly,<br>
><br>
> Anshil<br>
> _______________________________________________<br>
> cfe-dev mailing list<br>
> <a href="mailto:cfe-dev@lists.llvm.org" target="_blank">cfe-dev@lists.llvm.org</a><br>
> <a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev" rel="noreferrer" target="_blank">https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev</a><br>
</blockquote></div>
_______________________________________________<br>
cfe-dev mailing list<br>
<a href="mailto:cfe-dev@lists.llvm.org" target="_blank">cfe-dev@lists.llvm.org</a><br>
<a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev" rel="noreferrer" target="_blank">https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev</a><br>
</blockquote></div></div>