Very good questions...
Also, I didn't know that 0.7.1 was a CVS snapshot...I thought only the ones in the snapshot table were 'bleeding edge'
I missed the NEWS file thinking it would be stuff on the horizon for s9y and just version releasing info. doh!
My thinking on documentation...and I by no means want to offend anyone on this aspect...I haven't been using s9y for very long and am not even entirely fluent with the webpage yet and I haven't joined any mailing lists either (yet). I just figure I'd let you know my thinking on documentation. Who am I? Well, I am a tech writer in the USAF. I know how to bore the crap out of people extemely well through lambasting them with technical jargon. Anyways, my two cents:
I think that any major project such as s9y would do well to have good documentation. Forums are pretty cool but it's a known fact that phpbb lacks a good search capability. If it were me, I'd assign a docs manager to streamline documentation...first establishing criterion/templates for all docs that are submitted (such as for third party plugins) and create a core docs that surrounds the main functions/plugins/etc that ship with s9y. Then I'd announce the docs template/criteria and ask that plugin writers submit their info in compliance with the template (and I'd make it extremely easy to conform with). By making the template a 'fill in the blanks' style of template...it would be relatively easy to keep up to date. The Linux Documentation Project is a good example of how to do this. I've been involved with many open source and sourceforge.net projects...specifically the documentation process (website content as well) and I've found that
generally there is a lack of organization with documenation...it's a shame that this is so...especially for really great projects such as s9y.
The first thing a new user is going to look for is an organized FAQ system or documents in pdf format to get him/her started and going. Well, it's what I looked for and what I have always looked for since starting with Linux in 1994.
I would love to help out in any way I can...but I've not been using the software for very long.
If you can handle my sheepish inexperience with the software, I'd love to help
TKS