[llvm-dev] Debugging Docs and llvm.org/docs/

[Tanya Lattner via llvm-dev]

> On Apr 6, 2017, at 2:52 AM, Renato Golin <renato.golin at linaro.org> wrote:
> 
> On 6 April 2017 at 05:49, Dean Michael Berris <dean.berris at gmail.com> wrote:
>> I'll have a look if I can untangle that.
>> 
>> Thanks Renato!
> 
> Well, that didn't last long. Now I remember why last time I fixed
> hundreds of warnings on the docs directly instead of fixing the
> server...
> 
> 
>> Has anybody looked into potentially getting the LLVM docs hosted on
>> readthedocs.org and automatically built from the LLVM Git mirror (or through
>> Subversion post-commit hooks)? Since we're already using Sphinx, this seems
>> like a low-cost, low-interference way of hosting the generated
>> documentation.
> 
> This is actually a very good idea. I'll let Tanya and Anton further
> comment on that from a foundation's point of view.

The docs are built via SVN post-commit hook, but thats not the bigger issue in my opinion. I don’t know enough about readthedocs.org but if someone has a lot of experience.. perhaps they could summarize pros and cons of using it?

I’m not opposed to change just need to understand it. I’m actually going to be handing off most of this stuff as soon as I can write the email to the list (sorry its Spring Break here in the US so my time is limited this week). I have someone who is going to help with sys admin on llvm.org and head things up in that area but ideally its a team of people.

-Tanya

> 
> cheers,
> --renato