vessel changes
tests pass
documentation and cleanup