Documentation clean up, update to Documenter 1.0, add *.md to formatter (PSY portion)

[kdayday]

• Update to documenter 1.0 with settings to error during compilation for everything except document size and missing docstrings
• Add *.md files to formatter script and run formatter on documentation
• Update dynamics data tutorial by merging with another tutorial in PSID
• resolve missing docstrings list
  • adding missing PSY files to API (mostly dynamics devices)
  • removing IS from makedocs
  • selecting only the IS functions/types that are exported by PSY through a new filter function
• make cost doc strings visible again after migration to IS
• Make JSON serialization how-to have a realistic folder name instead of temp folder
• expanded explanation on Per unit, which needs a review from someone else
• resolve other asks from feedback from first documentation rewrite, including moving text and fixing/removing some examples that were erroring

Successful compilation with documenter 1.0 depends on docstring updates in IS NREL-Sienna/InfrastructureSystems.jl#394

Does not include moving the model library into API

Closes #1196

[codecov]

Codecov Report

Attention: Patch coverage is 33.33333% with 2 lines in your changes missing coverage. Please review.

Project coverage is 84.61%. Comparing base (fb41e06) to head (ba1a44d).
Report is 28 commits behind head on main.

Files with missing lines	Patch %	Lines
src/models/OuterControl.jl	33.33%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1176      +/-   ##
==========================================
- Coverage   84.61%   84.61%   -0.01%     
==========================================
  Files         180      181       +1     
  Lines        8267     8285      +18     
==========================================
+ Hits         6995     7010      +15     
- Misses       1272     1275       +3     

Flag	Coverage Δ
unittests	84.61% <33.33%> (-0.01%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
src/PowerSystems.jl	100.00% <ø> (ø)
src/models/branches.jl	100.00% <ø> (ø)
src/models/dynamic_generator.jl	84.37% <ø> (ø)
src/models/dynamic_inverter.jl	86.88% <ø> (ø)
src/models/generated/Line.jl	100.00% <ø> (ø)
src/models/generated/MonitoredLine.jl	94.28% <ø> (ø)
src/models/generated/PhaseShiftingTransformer.jl	94.28% <ø> (ø)
src/models/generated/TapTransformer.jl	100.00% <ø> (ø)
src/models/generated/Transformer2W.jl	100.00% <ø> (ø)
src/models/OuterControl.jl	64.70% <33.33%> (ø)

... and 3 files with indirect coverage changes

[jd-lara]

@rodrigomha who wrote this?

[rodrigomha]

probably me lol

[jd-lara]

There is some crazy text there lol

[kdayday]

Anything else to change?

[jd-lara]

We should mention that the tabular data parser is about to disappear.

[kdayday]

We should mention that the tabular data parser is about to disappear.

@jd-lara I split out the parsing how-to guide into separate topics, including a separate page on the tabular data parser with a warning at the top.

[kdayday]

Codecov Report

Attention: Patch coverage is 33.33333% with 2 lines in your changes missing coverage. Please review.

Project coverage is 84.61%. Comparing base (3ce7468) to head (be03b71).
Report is 19 commits behind head on main.

Files with missing lines Patch % Lines
src/models/OuterControl.jl 33.33% 2 Missing ⚠️
Additional details and impacted files

I think the two setters I added are covered by test_accessors already

[rodrigomha]

I'm happy with this PR to be merged