Some minutes ago, I've added, only to HEAD, one new NEWMODULE that looks better than the older one (credit goes to Chris B Stones). It will be ready for download in 24h from:

http://download.moodle.org/plugins/mod/NEWMODULE.zip

I would propose to:

1) Create one page in Docs to detail each function in module.
2) Add links from that page to sensitive places in Docs (roles, db, coding...)
3) Open it to further discussion in moodle.org
4) Modify the module to show how new core things are supposed to work (upgrade, backup & restore, roles and capabilities...)

Once the NEWMODULE is ready, backport it to 18_STABLE.