Cleanup Api docs

[SpacemanPaul]

Reason for this pull request

Cleanup and expansion of the curated API docs.

Proposed changes

• Add LineageTree to model documentation

• Replace lingering reference to DatasetType with Product

• Fix broken directives in masking

• Closes #xxxx

• Tests added / passed

• Fully documented, including docs/about/whats_new.rst for all changes

---

📚 Documentation preview 📚: https://datacube-core--1688.org.readthedocs.build/en/1688/

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 85.61%. Comparing base (8f3e5a9) to head (0ed0a34).
Report is 2 commits behind head on develop-1.9.

Additional details and impacted files

@@             Coverage Diff              @@
##           develop-1.9    #1688   +/-   ##
============================================
  Coverage        85.61%   85.61%           
============================================
  Files              151      151           
  Lines            15528    15526    -2     
============================================
- Hits             13294    13293    -1     
+ Misses            2234     2233    -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.