Clarify some comments / docstrings

[mfisher87]

Some minor tweaks to comment/docstring wording I made while I was touching code in another branch. Extracted for separate review.

[github-actions]

👈 Launch a binder notebook on this branch for commit 598c3dc

I will automatically update this comment whenever this PR is modified

👈 Launch a binder notebook on this branch for commit 65bf2d2

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 65.36%. Comparing base (50f9351) to head (65bf2d2).
Report is 25 commits behind head on development.

Additional details and impacted files

@@             Coverage Diff              @@
##           development     #592   +/-   ##
============================================
  Coverage        65.36%   65.36%           
============================================
  Files               36       36           
  Lines             3037     3037           
  Branches           531      531           
============================================
  Hits              1985     1985           
  Misses             970      970           
  Partials            82       82           

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