[GNC-dev] Register Documentation Improvements (was Re: [GNC] Column widths again)

[David Carlson]

I too am confused now.  First, I think David <sunfish62 at yahoo.com
<sunfish62 at yahoo.com>> stated in the other documentation thread that the
document names need to be clarified, and that may be part of why I am
confused.  I think that the short names seem to be Guide and Tutorial,
which, if they were used consistently, would work for me.  I may be wrong
about the names.

Second, I think that there may be an alias issue, and I am not sure where I
am sometimes because of that. In my last foray into online documentation I
was specifically trying to get to the current stable (Release 3) version of
the documentation, and when I repeat my itinerary as I tried to describe in
previous posts, I do end up in pages identified as ../v3/..  So I am
puzzled that Adrien does not seem to get to the same place, or how some of
my previous attempts to document the trip do not seem to be leading to
pages identified as ../v3/..

Third, I think that document title and chapter numbers do not appear on
every page in each form of the documentation, and that has not helped me to
keep track of where I am.

Fourth, the label on the link in the tip just below figure 4.3 of the help
manual is named Tutorial and Concepts Guide and it does seem to point to
the Tutorial ../v3/..section 4.2, so it seems correct for the current
document structure.

I am not trying to rant, just document my confusion and agreement that
simplification would be helpful.

David C

On Mon, Aug 20, 2018 at 4:30 PM, Adrien Monteleone <
adrien.monteleone at lusfiber.net> wrote:

> Hmm.. Not sure how I missed that recently. (I’ve read it before)
>
> But then if it’s there, I wonder why so many questions still? Perhaps the
> organization or presentation isn’t very discoverable? User laziness?
>
> Also, I still don’t think after several years that I’m clear on the
> difference between the Help Manual and the Tutorial & Concepts Guide. I get
> what their names imply and I understand the explanation on the website, but
> here is a case of info that I would expect to find in the other document.
> This is info about the GUI itself, not ‘how to use’ GnuCash to accomplish
> an accounting task. (which the name “Tutorial & Concepts Guide” implies and
> even the website itself defines as the document’s function)
>
> Should this be relocated to the Help Manual?
>
> Regards,
> Adrien
>
> > On Aug 20, 2018, at 3:44 PM, D <sunfish62 at yahoo.com> wrote:
> >
> > And you will find said documentation in the Guide at 2.3.3.
> >
> > David
> >
> > On August 20, 2018, at 2:32 PM, Derek Atkins <derek at ihtfp.com> wrote:
> >
> >
> > On Mon, August 20, 2018 2:20 pm, Adrien Monteleone wrote:
> >> Of course, that all makes sense.
> >>
> >> The other improvements, specifically how to resize columns, particularly
> >> the Description column I think should be documented. There are enough
> >> questions on the list about it to address the topic.
> >
> > Absolutely!
> >
> >> Regards,
> >> Adrien
> >
> >> Please remember to CC this list on all your replies.
> >> You can do this by using Reply-To-List or Reply-All.
> >
> > -derek
> > --
> >       Derek Atkins                 617-623-3745
> >       derek at ihtfp.com             www.ihtfp.com
> >       Computer and Internet Security Consultant
>
> _______________________________________________
> gnucash-devel mailing list
> gnucash-devel at gnucash.org
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel
>