Hi,
right now we have a lot of different 'documentation files', like the README, some specs, and guides and tutorials.
I'd like to restructure that a bit and centralize the documentation a bit.
On the "push" landing page ([1]), I'd like to change the "Lean More" link to a new page that has all the UPS centric documentations
The format of the reference guide would be similar to the one from Keycloak ([2]). But... I will continue using asciidoc ;-)
The README will be extremely quick and simply link to the homepage ;-) After this new reference guide, I think some of the current specs can be removed, as the reference guide hopefully covers all of their content :-)
For the RESTful APIs, I have to look what Keycloak did to get something like:http://docs.jboss.org/keycloak/docs/1.0-beta-3/rest-api/overview-index.html
After the work as been completed, I will be revisiting the specs and evaluate their need ;-)
This section will contain links to all the different tutorials we have:
For Cordova we will have one single document, instead of three:
There is already a JIRA for that ([4]).
To make it more clear (or clean?), I will remove the UPS/Push related docs from our guides ([3]) and replace all those links by a single link to the above mentioned new page (also referenced from [1]).
Greetings,
Matthias