[GNC-dev] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

[Adrien Monteleone]

Thanks for the info and clarification.

Regards,
Adrien

> On Apr 25, 2020 w17d116, at 2:27 AM, Geert Janssens <geert.gnucash at kobaltwit.be> wrote:
> 
> Op zaterdag 25 april 2020 09:17:58 CEST schreef Geert Janssens:
>> Op zaterdag 25 april 2020 01:09:56 CEST schreef Adrien Monteleone:
>>> I’ve used some documentation from that source for several projects (as a
>>> user, not a documenter) and I have to say it is much more pleasant to read
>>> and navigate than the current GnuCash setup.
>>> 
>>> There was some discussion some time ago (I think there is a bug filed) for
>>> making documentation more accessible for editing. The current procedures
>>> are a bit of a hurdle, at least enough to result in few people tackling
>>> needed changes.
>>> 
>>> Thanks for this effort. Do I see correctly that I could jump in for
>>> editing
>>> via GitHub? I haven’t played with RST yet.
>> 
>> While ReadTheDocs does support it, it doesn't match with our current
>> tooling. The GitHub version of our documentation is just a clone of the
>> real source location: code.gnucash.org. So any changes on github will be
>> overwritten when a change is pushed to code.gnucash.org.
>> 
> Let me correct myself.
> 
> IIRC this edit feature works by generating a clone of the gnucash-docs repo and after editing it 
> will guide you in making a pull request. That actually would work. The devs would just not use 
> github's merge functionality.
> 
> Regards,
> 
> Geert