added some new docs from bronkhorst