Implement review feedback

Some highlights: fix class/interface syntax; additional class/method docs; Manager convenience methods; more value objects.