You're right on the requirement part. And yes the plan is definitively to have the doc generated online like http://apidoc.ez.no or on some github pages.