major docgen update, minor API changes & bugfixes