Improve API documentation

[AdrianBenson]

API documentation requires improvement

• Ensure docstrings consistent with function/class signatures
• Break API docs into logical sections (e.g. Observations, Reductions) - consider separate pages fro each section
• Provide some text to describe sections
• Reorder elements to reflect usage patterns
• Remove type annotations from method in docs