Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-07 Thread Stan Brown
On 2020-05-06 20:46, Adrien Monteleone wrote: > I’ve found myself searching the docs just to find a reference to point to, > and then either found the docs lacking, not clear, or the search simply > taking longer than just typing out an answer. I’m not sure if there is a > resolution for such

Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-06 Thread David Cousens
Adrien, The wiki is currently an entry point for your Group 2 people to provide input and it is a route already in place to migrate documentation from the wiki to the formal docs. I am in the process of migrating the trading accounts documentation although what was in the wiki was not much more

Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-06 Thread Adrien Monteleone
Yes, I admit, I’m guilty in many cases of long-winded explanations and examples rather than simply referencing the docs. I have done that a few times, especially where I recall a recent thread on the same subject. I think overall, referencing docs is preferable. I’ve found myself searching the

Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-06 Thread D. via gnucash-user
- Original Message From: Adrien Monteleone Sent: Thu May 07 05:49:14 GMT+05:30 2020 To: Gnucash Users Subject: Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org > On May 6, 2020 w19d127, at 5:53 PM, David Cousens > wrote: > > The existing tool chai

Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-06 Thread Adrien Monteleone
> On May 6, 2020 w19d127, at 5:53 PM, David Cousens > wrote: > > The existing tool chain meets more than the need for a single document. There > is translation into multiple languages, online versions, standalone pdf, > epub etc. The Read theDoc' format is certainly quite nice but to be a >

Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-06 Thread David Cousens
The existing tool chain meets more than the need for a single document. There is translation into multiple languages, online versions, standalone pdf, epub etc. The Read theDoc' format is certainly quite nice but to be a replacement candidate for the current tool stream it has to offer

Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-06 Thread Kevin Buckley
On Wed, 6 May 2020 at 15:20, Adrien Monteleone wrote: > > Thanks for the bug reference. Certainly, I agree change won’t happen soon, or > easily, nor do I think it should. > > The point of my post was to encourage the OP not to lose hope or give up. > > Regards, > Adrien As someone else who's

Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-06 Thread flywire
On 5/6/2020 11:15 AM, Adrien Monteleone wrote: > ... I personally would like to see its development move to something with less of a hurdle or learning curve as that could include more seasoned users who aren’t build savvy. - That's certainly one potential benefit. A few comments from

Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-06 Thread Adrien Monteleone
Thanks for the bug reference. Certainly, I agree change won’t happen soon, or easily, nor do I think it should. The point of my post was to encourage the OP not to lose hope or give up. Regards, Adrien > On May 6, 2020 w19d127, at 1:57 AM, David T. wrote: > > Adrien, > > Given that the dev

Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-06 Thread David T. via gnucash-user
Adrien, Given that the dev team has discussed documentation formats since at least 2013 (cf. https://bugs.gnucash.org/show_bug.cgi?id=722016), I wouldn't expect a rapid transition to some other format just because someone comes up with a fancy new tool. David T. On 5/6/2020 11:15 AM,

Re: [GNC] Porting the Tutorial & Concepts Guide to ReadTheDocs.org

2020-05-05 Thread Adrien Monteleone
Could be it just hasn’t been seen widely yet. Posts here are odd beasts in that some get lots of activity and others nary a peep. Being that they are mail, this may be a semi-permanent condition for a thread. I’ll hazard a guess that it may have been appealing more for potential documenters

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

2020-05-05 Thread flywire
I thought there would have been more comments on Porting the Tutorial & Concepts Guide to ReadTheDocs.org tested recently at https://gnucash-docs-rst.readthedocs.io/ ___ gnucash-user mailing list gnucash-user@gnucash.org To update your subscription