I'll volunteer to help...

[Chris Lyttle]

On Tue, 2003-08-12 at 17:01, Jon Lapham wrote:
> >>The FAQ is here:
> >>http://www.jandr.org/temp/gnucashdocs/appendixb.html
> >>
> >>Just send your updates to the list for discussion.
> > 
Well you're putting them there from the lack of an easy way for you to
get them on gnucash.org. Hopefully soon you'll be able to put them on
gnucash.org yourself and update it as needed.

> Well, I don't think we really have maintainers, in the usual sense, for 
> parts of the documentation.  If Michael wants to add/edit FAQs, he (or 
> anyone else) would be appreciated and welcomed.
> 
> However, I am a believer in Keep It Simple, and I see no reason why the 
> FAQ should be a separate document.  We can make links to it directly 
> from the web page, no reason why we couldn't do that.  If it needs to be 
> split up (because it becomes too large), the current docbook 
> implimentation can handle that, you can add sections, and subsection, 
> and subsubsections, no need to change anything.

I agree with you here, Jon, it would be best to have additions to the
FAQ as docbook xml, but if people feel they don't know it well enough to
write in that format they can submit it to the -devel list for
discussion and hopefully one of us will find time to put it into XML.
The XML format was chosen to make it easy to spit out HTML or any other
format (like PDF) that we'd want to see the docs in. Michael I encourage
you to join Jon and I on the gnucash-docs team to improve the
documentation.

> Now, that is just how I decided to do the FAQ, certainly not necessarily 
> the best way.  :)  I figured that until we had a complete guide, this 
> was the best approach.  But, I see what you mean, put the *actual* most 
> frequently asked questions there...
> 
I have a feeling the *actual* FAQ's would be best in the wiki. But until
that is working your approach makes sense to me.

> > Also, the answer to "Is there a batch mode (non-interactive) available
> > for GnuCash, for building reports, etc?" is not entirely true. How about
> > gnucash --add-price-quotes file.xac?
> 
> I'm not familiar with this.  What does it do?  Looking at the wording, 
> "add-price-quote", I'm guessing adds prices to stock quotes, probably 
> using the Finance::Quote mechanism?  If so, then this should get 
> documented in the investment chapter, section "setting stock price".
> 
Yeah there is this mode, I believe it is in the 1.6 docs still. Its
basically for updating price quotes without having to open GnuCash. Got
lost in the 'write-new-docs' shuffle.

Chris
-- 
RedHat Certified Engineer #807302549405490.
Checkpoint Certified Security Expert 2000 & NG
--------------------------------------------
	|^|
	| |   |^|
	| |^| | |  Life out here is raw 
	| | |^| |  But we will never stop
	| |_|_| |  We will never quit 
	| / __> |  cause we are Metallica
	|/ /    |
	\       /
	 |     |
--------------------------------------------