BS-10271 : As Dave, I need to know about the Engine API

- Update the javadoc