[Grok-doc] proposed 1.0 release text

[Martijn Faassen]

Hey,

On Thu, Oct 1, 2009 at 6:36 PM, Sebastian Ware <sebastian at urbantalk.se> wrote:
> I am missing "who is this for?" I don't think we should pitch Grok 1.0 so
> much as a framework for "beginners". They will only get frustrated.

Beginners tend to get frustrated anyway, no matter what the framework.
:) But I'll try to de-emphasize.

> I think
> we should target pioneers who are prepared to drop into the debugger and
> read source code to understand what is going on.
>
> I am adding some suggestions.

Thanks for the suggestions. I don't want to mention other competing
frameworks in the release announcement, however. Grok should be
explainable by itself.

Here's a new version:

The Grok_ development team is very happy to release Grok 1.0. Grok 1.0
is the culmination of 3 years of work after the start of the Grok
project in late 2006. It presents a stable platform for developing
powerful, extensible
web applications. Grok is the result of years of work by the large
Grok development
team.

With Grok, simple projects are easy to create, but it is with
increasing complexity and
reuse that the Grok framework excels.

Grok 1.0 is not the end of Grok development. Since Grok is extensible
many powerful new features are being made available as growing collection of
extension packages. The Grok development team is also working on a whole
range of initiatives to improve Grok even further. The Grok
documentation team is
also busily working on improving Grok's extensive documentation resources.

.. _Grok: http://grok.zope.org

About Grok
-----------------

Grok is a modern Python-based web framework. Grok is powerful in the
hands of an expert developer, as it excels in reuse and extensibility
thanks to its use of a component development model. At the same time
Grok aims to let less experienced developers be productive immediately, so that
the walk up the learning curve is more smooth for them.

Grok lets you store your Python objects easily in the battle-tested
ZODB, an object database. Alternatively relational databases are
supported with Grok, using the `megrok.rdb`_ extension and SQLAlchemy.

.. _`megrok.rdb`: http://pypi.python.org/pypi/megrok.rdb

Grok is developed in the Zope community and is built with Zope
technologies. In particular, Grok builds on the `Zope Toolkit`_, a
collection of libraries that make use of a common component
development model, the Zope Component Architecture. The Zope community
has more than a decade of experience in developing web applications
with Python. The Zope Toolkit is the result of this experience,

.. _`Zope Toolkit`: http://docs.zope.org/zopetoolkit/

Grok is WSGI compatible and can therefore be integrated with the wide
range of WSGI-based technologies available in the Python world today.

Grok technologies themselves are also available for reuse. This has
enabled developers to use them in combination with the Silva and Plone
CMS projects, which work with the Zope 2 application server.