update documentation for public classes