Convert rules document to an automated ReadTheDocs build, add comments to metadata files - #159

Draft

mkavulich wants to merge 21 commits into

mainfrom

feature/readthedocs

Commits on Sep 21, 2026

Update rules per discussion on #150
mkavulich
committed
b731a18
Starting update of "surface" variables; give a more detailed "surface_skin_temperature" definition, and return proper skin temperature naming accordingly
mkavulich
committed
2a1cdb7

Commits on Sep 22, 2026

Converting atmospheric references to 'at_surface' to 'at_boa'. We'll see if this sticks...
mkavulich
committed
8be6a3b
"Surface friction velocity" is redundant...can just use "friction velocity"
mkavulich
committed
82609b2
rename strangely named "surface temperature scale" to the better-defined "friction-temperature", including definition and citation.
mkavulich
committed
de4de49
Reverting "boa" definitions...this is not an acceptable substitute for "at_surface_interface" due to existing conflicting definition of "bottom-of-atmosphere" in radiation community. Will stick wit…
mkavulich
committed
9ffbdfa
Sort xml and generate new Metadata
mkavulich
committed
996bb24
Resolve issue 156 per discussion there
mkavulich
committed
6a24614
Missed one abbreviation in description
mkavulich
committed
ca4b78e
Remove duplicate "friction_velocity" entry, clarify description of base name
mkavulich
committed
23d782d
More clarity and additional "skin temperature" definitions
mkavulich
committed
3a2f92c
Fix non-ASCII character
mkavulich
committed
36899d1
Fix abandoned sentence fragment
mkavulich
committed
efce041
Fix write_standard_name_table.py to write comments for standard_name entries
mkavulich
committed
2805c26
Reorganize StandardNamesRules.rst into a chaptered Sphinx/ReadTheDocs site

mkavulich
and
claude
committed
cef758f
Fix RST markup bugs surfaced by strict Sphinx build

mkavulich
and
claude
committed
3064c8c
Embed linked images as figures with captions and alt text

mkavulich
and
claude
committed
f7f7c38
Change formatting of qualifiers/suffixes/prefixes for better visual flow
mkavulich
committed
9a99414
Better location to build docs locally
mkavulich
committed
93625a3
Better formatting for "naming rules" chapter
mkavulich
committed
eeedf62

Commits on Sep 23, 2026

Simplify code to pass pylint branches check
mkavulich
committed
93dcc95