added default value for parameters to the api docs. A number of other tweaks as well