Re: [Mesa-dev] Proposal: move the Mesa documentation to readthedocs.org

2016-09-11 Thread Nicholas Bishop
Good questions, > 1. How can we minimize the effort of maintaining two repositories? (I don't > think anyone here would support dropping the HTML docs, as they feed into > the main Mesa website). I agree that maintaining two repos would be bad, but we don't need to do that. Sphinx can generate

Re: [Mesa-dev] Proposal: move the Mesa documentation to readthedocs.org

2016-09-11 Thread Rhys Kidd
On 27 August 2016 at 01:09, Nicholas Bishop wrote: > Hi, > > I'd like to propose a conversion of Mesa's documentation to > reStructuredText (RST) and hosting the result on readthedocs.org. The > intent is to make Mesa's documentation more accessible, searchable, and >

Re: [Mesa-dev] Proposal: move the Mesa documentation to readthedocs.org

2016-09-07 Thread Vedran Miletić
On 09/07/2016 07:58 PM, Nicholas Bishop wrote: > Bump, any interest in this? > In my experience rST is much nicer to write than pure HTML, and I like how the output looks. Definitive yes on the rST instead of HTML, no strong opinion on readthedocs.org vs self-hosted. Regards, Vedran -- Vedran

Re: [Mesa-dev] Proposal: move the Mesa documentation to readthedocs.org

2016-09-07 Thread Nicholas Bishop
Bump, any interest in this? On Sat, Aug 27, 2016 at 1:09 AM, Nicholas Bishop wrote: > Hi, > > I'd like to propose a conversion of Mesa's documentation to > reStructuredText (RST) and hosting the result on readthedocs.org. The > intent is to make Mesa's documentation more

[Mesa-dev] Proposal: move the Mesa documentation to readthedocs.org

2016-08-26 Thread Nicholas Bishop
Hi, I'd like to propose a conversion of Mesa's documentation to reStructuredText (RST) and hosting the result on readthedocs.org. The intent is to make Mesa's documentation more accessible, searchable, and easier to edit. I put together a quick proof-of-concept here: