Follow-up to #5083: Minor Doc Fixes

[HereAround]

• Add # Examples to all FTheoryTools docstring examples.
• Enforce imperative in doc strings by renaming Returns to Return (and friends) in doc strings.

cc @apturner @emikelsons

[HereAround]

@lgoettgens As discussed last week, this is a follow-up to #5083. Please consider merging if you are satisfied.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 84.84%. Comparing base (0ae639f) to head (526622b).
Report is 3 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #5145      +/-   ##
==========================================
- Coverage   84.85%   84.84%   -0.01%     
==========================================
  Files         710      710              
  Lines       95410    95466      +56     
==========================================
+ Hits        80964    81002      +38     
- Misses      14446    14464      +18     

Files with missing lines	Coverage Δ
...ools/src/AbstractFTheoryModels/basic_attributes.jl	76.00% <ø> (ø)
...s/src/AbstractFTheoryModels/computed_attributes.jl	95.45% <ø> (ø)
.../FTheoryTools/src/AbstractFTheoryModels/methods.jl	52.69% <ø> (ø)
...rc/AbstractFTheoryModels/precomputed_attributes.jl	100.00% <ø> (ø)
...heoryTools/src/AbstractFTheoryModels/properties.jl	80.00% <ø> (ø)
...yTools/src/AbstractFTheoryModels/qsm_attributes.jl	100.00% <ø> (ø)
...ls/src/AbstractFTheoryModels/section_attributes.jl	100.00% <ø> (ø)
...al/FTheoryTools/src/FamilyOfG4Fluxes/attributes.jl	80.59% <ø> (ø)
.../FTheoryTools/src/FamilyOfG4Fluxes/constructors.jl	68.88% <ø> (ø)
...ental/FTheoryTools/src/FamilyOfG4Fluxes/methods.jl	96.96% <ø> (ø)
... and 20 more

... and 6 files with indirect coverage changes

🚀 New features to boost your workflow:

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

[lgoettgens]

Could you also check for words like Checks, Creates, Computes, and Constructs as the first word of a docstring. Those should also lose the s, analogous to Returns.

[HereAround]

Could you also check for words like Checks, Creates, Computes, and Constructs as the first word of a docstring. Those should also lose the s, analogous to Returns.

I checked and modified all of these. In additions found Adds which I changed accordingly. I could not find anything else at the top of my head (Sets, Reads, Verifies, ...), so hopefully this is complete.

[lgoettgens]

Thanks! I didn't check that you got all cases, but the cases you did change look good.