reworked doc section, heavily inspired by polyester and svens work on docs.plone.org