[jazzplusplus-devel] Web Content and Documentation

[Pete S. <pst...@ve...>]

DM>>> interest to check jazzplusplus out, along
DM>>> with some (realistic) estimation of when
DM>>> userland type tarballs are expected to be
DM>>> available....

PS>> That estimate will be tough for me to come up with.
PS>> What do you think of this version...
PS>>
PS>> http://jazzplusplus.sourceforge.net/download/

DM> Yeah, the release time estimation consideration
DM> is always tough. Mind you, the actual value might
DM> change at any time, and could be updated when so.
DM> For example, 'now' that estimation might be 'before
DM> the end of 2009', but in 3months time it might be
DM> 'by the end of this year'....it's a mobile target.

Let me think about this one...

DM> There's a small typo here and there on the
DM> download page, there's a few more likewise on
DM> other pages which I've caught on the 3rd pass.
DM>
DM> Rather than load you up with all these minor
DM> corrections,  I'll ask first if these fixups
DM> will be better served by me having a working
DM> setup of whatever documentation generation
DM> process you prefer to use?
DM>
DM> I'll hold these little corrections in check
DM> until I hear back on that....

OK.  What do you think about the following.

1. I'll put the web content in subversion so you can send me patches.
2. I make this weekend's goal the setting up of the online help/web 
user's manual build system.  It will be similar to building code.

I want to separate the two for a while.  Seem reasonable?

DM>>> ....and, if it were there, pointers to other
DM>>> docs on the site of other software already
DM>>> known to be working with devel versions
DM>>> of jazzplusplus, screenshots --

PS>> Currently I have the screen shot page commented out.

DM> Ah, okay...noted...

DM>>> I'll wait for your reply to this before
DM>>> reposting ....oh, and if you'd rather this
DM>>> private, that's fine too....

PS>> No.  I prefer a public discussion to get others interested.

DM> Agreed -- open discussion of such things on
DM> *this* list, gives every possible opportunity
DM> for the intended users of jazzplusplus to have
DM> some say in what happens next.

I did move this discussion over to the developers list because it is 
going to get into how the documentation is built instead of what it 
contains.  Feel free to keep a thread alive on the user list.

DM>>> let me know, but like that the record
DM>>> shows that there's some depth of thought
DM>>> going into the revitalized jazzplusplus

PS>> Exactly! :-)

DM>>> fork...

PS>> Keep in mind, this isn't a fork
PS>>
PS>> http://en.wikipedia.org/wiki/Fork_(software_development)
PS>>
PS>> I'm just building on the work of others without
PS>> splitting off.

DM> ...oops! I'll make sure to get that right from now on....

I just don't want to tick off the kind folks that let me have a go at 
this.  Thanks again, Pat, Dave, Kevin...

DM>>> I'll do a 3rd pass over things in the interim.

PS>> Great.  Thanks.

DM> Yep, as I mentioned above, 3rd pass revealed a few
DM> small oversights, but if the correcting/editing
DM> process is going to be streamlined by my using
DM> your preferred document generation method, then
DM> I would rather move to that method sooner than
DM> later.

If you approve of the idea, I'll put the web content in subversion and 
you can send me patches.

DM>>> ps: excuse my impoliteness, I didn't ask if
DM>>> you wanted American, or British spelling,
DM>>> sorry. You would have received Australian
DM>>> spelling by default -- please advise which
DM>>> english varient you prefer so I avoid
DM>>> spelling 'bolour' with a 'k'....

PS>> American English please.  Thanks for asking.

DM> No problem,,,,

Thanks,
Pete