<div dir="ltr">I like this a lot!<div><br></div><div>I commented on the patch since I didn't see this thread at the time, but it'd be interesting to perhaps replace Epydoc with Sphinx as well.</div><div><br></div><div> - Bruce</div><div><br></div></div><br><div class="gmail_quote"><div dir="ltr">On Fri, Dec 7, 2018 at 12:02 AM Jonas Devlieghere via lldb-dev <<a href="mailto:lldb-dev@lists.llvm.org">lldb-dev@lists.llvm.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space">Hi everyone,<div><br></div><div><div>The current LLDB website is written in HTML which is hard to maintain. We have quite a bit of HTML code checked in which can make it hard to differentiate between documentation written by us and documentation generated by a tool. Furthermore I think text/RST files provide a lower barrier for new or casual contributors to fix or update.</div><div><br></div><div>In line with the other LLVM projects I propose generating the documentation with Sphix. I created a patch (<a href="https://reviews.llvm.org/D55376" target="_blank">https://reviews.llvm.org/D55376</a>) that adds a new target docs-lldb-html when -DLLVM_ENABLE_SPHINX:BOOL is enabled. I've ported over some pages to give an idea of what this would look like in-tree. Before continuing with this rather tedious work I'd like to get feedback form the community.</div><div><br></div><div>Initially I started with the theme used by Clang because it's a default theme and doesn't require configuration. If we want to keep the sidebar we could use the one used by LLD.</div></div><div><br></div><div>Please let me know what you think.</div><div><br></div><div>Thanks,</div><div>Jonas</div></div>_______________________________________________<br>
lldb-dev mailing list<br>
<a href="mailto:lldb-dev@lists.llvm.org" target="_blank">lldb-dev@lists.llvm.org</a><br>
<a href="http://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-dev" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-dev</a><br>
</blockquote></div>