<html><head><meta http-equiv="Content-Type" content="text/html; charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Hi Jonas, I think this is a great effort. Thanks!<div class=""><br class=""></div><div class="">My current reviews do some small updates on the build page. Hope this doesn't get in conflict with your work?</div><div class=""><br class=""></div><div class="">Best</div><div class="">Stefan<br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On 6. Dec 2018, at 18:02, Jonas Devlieghere via lldb-dev <<a href="mailto:lldb-dev@lists.llvm.org" class="">lldb-dev@lists.llvm.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><meta http-equiv="Content-Type" content="text/html; charset=us-ascii" class=""><div style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Hi everyone,<div class=""><br class=""></div><div class=""><div class="">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 class=""><br class=""></div><div class="">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" class="">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 class=""><br class=""></div><div class="">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 class=""><br class=""></div><div class="">Please let me know what you think.</div><div class=""><br class=""></div><div class="">Thanks,</div><div class="">Jonas</div></div>_______________________________________________<br class="">lldb-dev mailing list<br class=""><a href="mailto:lldb-dev@lists.llvm.org" class="">lldb-dev@lists.llvm.org</a><br class="">http://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-dev<br class=""></div></blockquote></div><br class=""></div></body></html>