REST API doc fixes

Some extra copy edits and documentation changes for the GeoServer REST API.