Re: [jazzplusplus-devel] Doccumentation -- a scratchpad of thoughts

[D.B. M. <db...@ho...>]

Greets,


----------------------------------------
> Date: Sat, 17 May 2008 20:05:31 -0700
> Subject: Re: [jazzplusplus-devel] Doccumentation -- a scratchpad of thoughts
> 
> DM = D.B. Moore
> DM> Call it sentimentality on my part if you like, but
> DM> I figure a copy of the original jazz.tex file should
> DM> always remain, in tact, for historical purposes...
> 
> It will because it us under version control.  On your Linux box, try the 
> following command in the jazzplusplus/trunk/jazz/src/HelpFiles directory...
> 
> $ svn log jazz.tex
> 

...snip.....

> 
> DM> Anyhow, reworking jazz.tex is almost tantamount
> DM> to a rewrite. I've got no problem with that,
> DM> and for sure some passages of the old text
> DM>  may find their way into the new draft....but
> DM> ....are we happy with the formal and layout of
> DM> the old jazz.tex documentation?
> 
> Here's how I look at it.  You are doing a fabulous job with the docs. 
> Feel free to re-write as you see fit.  When it comes to Jazz++ 
> functionality, assume we are trying to recreate what the old version 
> did.  I'm sure this is documented in the old version.  I have changed a 
> few things (I want to use my new knob control instead of sliders... see 
> the Metronome dialog), but not much.
> 
//personal barf
One thing I really dislike, is when parts suppliers change the order
of catalog sections every year a new edition of their parts catalog 
comes out....why do they do this?...it's like going to the supermarket
where they daily change the location of things in the store
//end

....and with this in mind, the original layout of the document will
be adhered as closely as possible. Text and descriptions still valid
for jazz++ -today- will remain. New sections will be added as needed,
inside or appended to the existing document structure, images updated
and so on. I don't want folks used to the existing manual to notice
anything different in feel&use of the revised edition, lest I be subject
to my own trivial disdains...

This posting informational only, so it's known just where I'm headed.


Regards,

Donald B
 .





_________________________________________________________________
Search for local singles online @ Lavalife - Click here
http://a.ninemsn.com.au/b.aspx?URL=http%3A%2F%2Flavalife9%2Eninemsn%2Ecom%2Eau%2Fclickthru%2Fclickthru%2Eact%3Fid%3Dninemsn%26context%3Dan99%26locale%3Den%5FAU%26a%3D30290&_t=764581033&_r=email_taglines_Search_OCT07&_m=EXT