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

[Geert Janssens]

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