<br><br><div class="gmail_quote">On Fri, Mar 7, 2008 at 4:46 PM, Martijn Faassen <<a href="mailto:faassen@startifact.com">faassen@startifact.com</a>> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Hi there,<br>
<br>
We want to do a release soon, I think. We have two choices:<br>
<br>
* release the trunk as 0.12<br>
<br>
* release the trunk as 1.0<br>
<br>
What would people prefer, and why?<br>
<br>
I'm a bit more likely to go for 0.12 right now. Two reasons:<br>
<br>
* we haven't moved to the proper versions of Zope 3.4 eggs yet, my one<br>
1.0 requirement.<br>
<br>
* I think a "1.0" release is a great way to catch a lot of attention.<br>
We'll be announcing the 1.0 plans to the public, then we have a beta,<br>
excitement mounts, etc. I'm not sure we're quite ready to do the proper<br>
buildup.<br>
<br>
Given all that, I prefer pushing out a 0.12 soon, then move on to work<br>
on the version issue. Unless a volunteer steps up and fixes all the egg<br>
versions to KGS-based ones very soon.<br>
<br>
Regards,<br>
<br>
Martijn<br>
<br>
_______________________________________________<br>
Grok-dev mailing list<br>
<a href="mailto:Grok-dev@zope.org">Grok-dev@zope.org</a><br>
<a href="http://mail.zope.org/mailman/listinfo/grok-dev" target="_blank">http://mail.zope.org/mailman/listinfo/grok-dev</a><br>
</blockquote></div><br><br><br>I normally just lurk in this list, but I had a thought I'd like to share. My vote is on the 0.12 release as I think good documentation should be coupled and stabilized with each release. I think the documentation (examples, how-to's, etc) are in a pretty good state right now, but one of the problems I have had with mainly Zope (and to a lesser extent Grok since it is still very new) is finding documentation that I know works with the release I am using. Many times I have found a useful document describing something I wanted to try out only to find that it it doesn't work. As a new user this is very frustrating as I didn't know enough about the overall system to know why it didn't work or what could be changed to make it work. <br>
<br>So basically my thought is that I would like to see (in whatever is deemed functional and maintainable) corresponding documentation with each significant or feature changing release. I think this will not only help with initial exposure to Grok, but also with long-term user retention. As an example see the MySQL documentation. Each significant release is accompanied by corresponding documentation. If I, as a user, see something documented I know right away if it will work with the version I am running, or if not then it can be justification for changing/upgrading.<br>
<br>I know it would be a difficult task that will probably require a volunteer team, but hopefully much of the documentation could simply be copied from release to release and only minor tweaks and updates in places. My time is often very limited, but I'd be willing to help in whatever way I can.<br>
<br>Lastly, this thought is just a basic proposal to begin discussion if there is interest. The only functional thought I've had at this point is to move the existing how-to's, etc into a 0.1x subfolder to act as a pre-1.0 container so the documentation can also be prepared for a 1.0 release.<br>
<br>Thanks,<br>-Justin<br>