Future "Tutorial and User Guide" direction

[Jon Lapham]

Christian Stimming wrote:
> I would agree with Derek here: One document should suffice for both Personal
> and Business guide. 

Okay, okay.  I'm convinced.  One document it is.  :)

> 
> My point is also that one document instead of two would keep maintenance and 
> translation much easier. Take the "Help" vs. "Guide" document as example -- 
> now eventually we got one translation of the Help document, but those guys 
> stayed far away from the other document. I.e. the threshold to tackle "yet 
> another document" is so giantic that I would absolutely vote for keeping this 
> in one document. This would mean other translators "only" need to translate 
> "yet another chapter" instead of tackling a whole new document... just my 2 
> cents.

Good point.

Speaking of the Help and Guide documents... can someone explain what is 
the philosophy behind them?

My understanding of what "help" pages are is to explain what things 
specifically do.  But, no discussions of "why" or "howto", and no 
discussions of the big picture.

However, reading through the help, there is a lot of "guide-esque" text. 
    For example, the "getting started" and a "customizing GnuCash" sections.

I'm not saying this is bad, I'm just curious.

-Jon

-- 
-**-*-*---*-*---*-*---*-----*-*-----*---*-*---*-----*-----*-*-----*---
  Jon Lapham  <lapham at extracta.com.br>          Rio de Janeiro, Brasil
  Work: Extracta Moléculas Naturais SA     http://www.extracta.com.br/
  Web: http://www.jandr.org/
***-*--*----*-------*------------*--------------------*---------------