gs-api, improve javadoc on model