JAL-535 tidy interface definition and documentation