review javadoc & swagger (see pages)