Docstring cleanups

[delucchi-cmu]

With changes in PR #853 , it's easier to read through individual property and method API docs. And it's easier to see where they need to be spruced up!

[github-actions]

Before [d519c3b]	After [9e5fe24]	Ratio	Benchmark (Parameter)
6.25±0.02s	6.41±0.02s	1.03	benchmarks.time_create_large_catalog
23.8±0.3ms	23.9±0.2ms	1.01	benchmarks.time_box_filter_on_partition
928±6ms	938±7ms	1.01	benchmarks.time_create_midsize_catalog
38.4±0.8ms	37.8±1ms	0.98	benchmarks.time_polygon_search
81.4±0.8ms	78.7±0.9ms	0.97	benchmarks.time_kdtree_crossmatch

Click here to view all benchmarks.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.19%. Comparing base (d519c3b) to head (9b34a41).
⚠️ Report is 154 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #859   +/-   ##
=======================================
  Coverage   95.19%   95.19%           
=======================================
  Files          54       54           
  Lines        2558     2561    +3     
=======================================
+ Hits         2435     2438    +3     
  Misses        123      123           

☔ 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.