NoQ added a comment.

I poked Devin offline. It kinda seems to both of us that Sphinx is great for 
documentation that is updated regularly, but our fancy front page should 
probably stay. Similarly to how we still have the llvm.org front page, despite 
all the documentation. It's kinda atmospheric and friendly and people like it 
and/or are used to it.

Pretty much all other pages will look great in Sphinx. Everything under "User 
Manual" would indeed look like a manual, everything under "Development" would 
look more technical and trustworthy, the "Filing Bugs" page is pretty weird and 
unfriendly and should probably be reworked or removed anyway, the 
"Obtaining..." page is pretty much outdated and contains no useful info apart 
from "If you want the latest Analyzer, compile Clang from source and add it to 
your `PATH`". I'm a bit unsure about the FAQ page, it kinda feels like it 
should be as close to the front page and visible on the front page as possible, 
in order to inspire people to actually read it. We should give it more 
visibility, not hide it within the manual.


CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D54429/new/

https://reviews.llvm.org/D54429



_______________________________________________
cfe-commits mailing list
cfe-commits@lists.llvm.org
http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits

Reply via email to