docs: Add docstrings for new location methods

[rich-iannone]

Given that there are now 11 loc classes (new ones added through #341), we need to ensure that there is sufficient documentation for these (addressing #467). We need at least one example in each of their docstrings. And we have to ensure these are all added to the API reference.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 87.84%. Comparing base (641a8d6) to head (591b211).
Report is 28 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #474   +/-   ##
=======================================
  Coverage   87.84%   87.84%           
=======================================
  Files          42       42           
  Lines        4838     4838           
=======================================
  Hits         4250     4250           
  Misses        588      588           

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

[machow]

Yooo this is looking so good!!!!

This is a small thought -- I wonder if changing...

• from "A location specification for targeting the..."
• to "Target the.."

might help keep the index a bit punchier. The downside might be the word "location" doesn't get used, but it's in the section description, so may be okay 😬?!

[rich-iannone]

^^^ great idea and I made that change!