Update observations.

Update both classes with doc standards, for parameters and returns, change some name methods.