
<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 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></body></html>