llvm dev - Apr 2017 - Debugging Docs and llvm.org/docs/

> On 3 Apr 2017, at 23:03, Renato Golin <renato.golin at linaro.org>
wrote:
> 
> On 3 April 2017 at 13:51, Dean Michael Berris <dean.berris at
gmail.com> wrote:
>> Thanks -- interesting that the docs haven't been updated since
March 15th:
> 
> Yes, this happens when the server's sphinx installation picked up on
> something that neither your installation or the buildbot's did.
> 
> I'll have a look if I can untangle that.
> 
Thanks Renato!
> cheers,
> --renato
> 
> PS: We really need a better way of doing this...

Has anybody looked into potentially getting the LLVM docs hosted on
readthedocs.org <http://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.

-- Dean

-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://lists.llvm.org/pipermail/llvm-dev/attachments/20170406/c4440bdf/attachment.html>

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.

cheers,
--renato

> 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