[Grok-dev] Grok 1.0a1 released!

[Martijn Faassen]

The Grok team is happy to announce the release of Grok 1.0a1. This is
the first step on the way to the release of Grok 1.0! With Grok 1.0 we
will deliver a stable, powerful, featureful framework for Python-based
web development. Grok 1.0a1 is a preview of the 1.0 release and a
continuation of the developments in Grok 0.14.

Changes
======

Grok 1.0a1 has the following changes compared to Grok 0.14:

* Grok now uses WSGI and paster out of the box. To create a project that
  uses paster, update grokproject (``easy_install -U prokproject``) first.

* Grok's REST support now works like layers have been for a while,
  using a ``grok.restskin`` directive on an interface.

* A new ``grok.DirectoryResource`` component is available that can be
  used to expose resources (CSS, Javascript, images) to the web the
  Grok way, similar to the way the ZCML ``resourceDirectory``
  directive can be used.

* We have split off a new package that Grok now depends on which
  contains the viewlet support (``grokcore.viewlet``). The use of
  viewlets with Grok remains unchanged, but this package can also be
  used independently.

* Besides our existing documentation we have started to add docstrings
  to the Grok source code to make it easier to understand.

This release also contains a number of bugfixes. We are continuing to
fix bugs on the way to Grok 1.0.

For installation instructions and much more on how to use Grok, see
the Grok tutorial: http://grok.zope.org/doc/current/tutorial.html

Upgrading
========

It should not be needed to change your code to upgrade an existing
project from 0.14 to 1.0a1, unless you use Grok's REST support.

For detailed upgrade notes on this, see
http://grok.zope.org/project/upgrade-notes

If you want to use the paster support, please examine a project
generated with the newest
version of grokproject and update your project's ``buildout.cfg``
accordingly (and help us write better instructions!).

We hope to hear from you!

If you enjoy Grok, please subscribe to the `grok-dev mailing list`_
and join us in the #grok channel on irc.freenode.net.

.. _`grok-dev mailing list`: http://grok.zope.org/community/grok-dev-mailinglist