Revise docstrings for build objects

[jwagenet]

Update object_*.py docstrings for more consistency. Clarify how parameters work and objects are constructed.

General improvements:

• follow a similar opening description: Add/subtract a {object} defined by... with more explicit behavior
• update union type declarations in string
• remove plurality references (sketch, part). Methods to create multiple parts/sketches occur outside the objects
• remove angles plurality from 1d and 2d objects
• remove hanging end stops (.) from lists
• try to make arg descriptions more consistent and descriptive
• try to specify viable enums if mentioned and CAPITALIZE
• other editing for wordiness

[gumyr]

Thank you for doing this. I only have one point to discuss:

All of the object description now start with "Add" which, given we're trying to tidy up the wording, might be a little confusing. Consider:

my_thing -= Circle(...)

where the docstring states that it will be added but the code is going to subtract it. Same with:

with BuildPart() as my_thing:
    ...
   Cylinder(..., mode=Mode.SUBTRACT)

How about we use a more neutral word like "Create" or something similar?

[jwagenet]

Yes, I agree, using Create is better because the object is created regardless of what happens in the context it modifies. I was going to use Create, but switched back to Add/Subtract to align with the default mode because of Hole/CounterSink/CounterBore. I can update.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.93%. Comparing base (c51410b) to head (7b55eb1).
Report is 5 commits behind head on dev.

Additional details and impacted files

@@            Coverage Diff             @@
##              dev     #930      +/-   ##
==========================================
- Coverage   96.93%   96.93%   -0.01%     
==========================================
  Files          32       32              
  Lines        9471     9470       -1     
==========================================
- Hits         9181     9180       -1     
  Misses        290      290              

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

[gumyr]

Thank you!