[Grok-doc] Review REST support document

[Paul Wilson]

Hi,

I'd like to review:

http://grok.zope.org/documentation/how-to/rest-support-in-grok

I've been writing my own REST protocol so have a bit of experience in this area.

I can already see one issue; the tutorial gives the example:

class AtomPubProtocol(grok.RESTProtocol):
   grok.layer(AtomPubLayer)
   grok.name('atompub') # a nicer name

whereas the release 1.0a1 lists in its featured changes:

 "the grok.RESTProtocol baseclass has been removed in favour of a
grok.restskin(name) directive that can be used on REST layer
interfaces"

Thus I believe we should retract it until it has been reviewed
properly and fixed (if needed).

Regards,
Paul