David C,

So for clarification this is the first link you posted about:

> https://www.gnucash.org/docs/v3/C/gnucash-guide/txns-register-oview.html#txns-regstyle1

Notice this is in the folder /docs/v3/C/gnucash-guide/

But the link on the Documentation page and the link you included (both in that 
first post and in the last one) that said how you got there was this:

> https://www.gnucash.org/viewdoc.phtml?rev=3&lang=C&doc=help

So yes, that IS version 3 (listed here as ‘rev=3’) but that’s not the same link 
as above. (though it might be the exact same content, I didn’t check)

I can’t find any way, other than typing it in directly, to get to the 
/docs/v3/C/ directory wherein lies the /gnucash-guide/ and /gnucash-help/ 
folders and contents. All of the links on the documentation page seem to point 
instead to the /viewdoc.phtml which never changes the URL as you navigate the 
document. (my guess is the viewdoc.phtml template is serving the pages 
physically located in /docs/v3/C/, we just can’t see the real URL)

------------

And now after I backed up a few directories from the first link above, I see 
regardless, *I* was in the wrong place. I didn’t see a ‘4.3' because I was 
looking at the section numbers which are roman numerals, not the chapter 
numbers. Section IV in the Guide are for the Appendices which are organized by 
letters. The only notation I saw then for 4.3 was in the Help Manual, which is 
where my confusion came from. (but that really is where I think this info 
should be - see my previous comment)

And sure enough there is https://www.gnucash.org/docs/v3/C/gnucash-help/ which 
I would have expected to see.

So, we can put aside the naming of the folder since that’s correct. But what 
certainly would be helpful is if the page itself indicated which document you 
were viewing. That bug is still there.

Regards,
Adrien


> On Aug 20, 2018, at 6:52 PM, David Carlson <david.carlson....@gmail.com> 
> wrote:
> 
> I too am confused now.  First, I think David <sunfis...@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.montele...@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 <sunfis...@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 <de...@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
> >       de...@ihtfp.com             www.ihtfp.com
> >       Computer and Internet Security Consultant
> 
> _______________________________________________
> gnucash-devel mailing list
> gnucash-devel@gnucash.org
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel
> 


_______________________________________________
gnucash-devel mailing list
gnucash-devel@gnucash.org
https://lists.gnucash.org/mailman/listinfo/gnucash-devel

Reply via email to