Add some documentation notes on lineages

[jeromekelleher]

Closes #2294

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.23%. Comparing base (1c3e143) to head (8912fe4).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2390   +/-   ##
=======================================
  Coverage   91.23%   91.23%           
=======================================
  Files          20       20           
  Lines       11828    11828           
  Branches     2295     2295           
=======================================
  Hits        10791    10791           
  Misses        568      568           
  Partials      469      469           

Flag	Coverage Δ
C	91.23% <ø> (ø)
python	98.68% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.