Kauri documentation refactoring overview

document with remarks about the current version of the documentation of kauri 0.4

Apparently there is no documentation about URIs like the following:

"uri": '${publicUri('service:/myRouter')}/acc/byRoles/{-list|,|roles}'

The structure {-list|,|roles} is used to define the separator between the different values of "roles". But apart from -list, the following options also exist: -prefix, -append, -opt, -neg and -join. It is not clear how, when and why to use these.

It would also be useful if the documentation mentioned how to assign a default value to a variable, like this: {id=-1}

The explanation on the following page is quite clear and could be used as a reference:

http://bitworking.org/projects/URI-Templates/spec/draft-gregorio-uritemplate-03.html