Updated RDA addresses and dataset names

[kdraeder]

Description:

NCAR's Research Data Archive changed their dataset naming convention,
so all the references in DART became outdated.
The "local" (/glade) versions were also moved to a new location (/glade/campaign) when derecho replaced cheyenne.

Did not update
./CHANGELOG.rst
./_build/html/CHANGELOG.html
./_build/html/_sources/CHANGELOG.rst.txt

These substitutions were made:
sed \
-e "s#glade/collections#glade/campaign/collections#" \
-e "s#edu/ds/#edu/datasets/ds#g" \
-e "s#ds345.0#d345000#g" \
-e "s#ds199.1#d199001#g" \
-e "s#ds090.0#d090000#g" \
-e "s#ds337.0#d337000#g" \
-e "s#ds285.0#d285000#g" \

@hkershaw-brown I updated some .html files too, and would like confirmation that that was
the right thing to do.

@braczka Please check some of the CLM files, but I think that you don't need check all of them.

I did not add DOIs for these datasets, which would be more robust, but more work.

Fixes issue

#755

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update

Documentation changes needed?

• My change requires a change to the documentation.
  • I have updated the documentation accordingly.

Tests

I checked the changes in
./models/POP/shell_scripts/cesm2_1/user_datm.streams.txt.CPLHISTForcing.Solar_template

I did not test any of the testable files.

Checklist for merging

• Updated changelog entry
• Documentation updated
• Update conf.py

Checklist for release

• Merge into main
• Create release from the main branch with appropriate tag
• Delete feature-branch

Testing Datasets

• Dataset needed for testing available upon request
• Dataset download instructions included
• No dataset needed

[hkershaw-brown]

@hkershaw-brown I updated some .html files too, and would like confirmation that that was
the right thing to do.

Does not look like any html files in this pull request. Do you mean the .rst files?

[kdraeder]

@hkershaw-brown I updated some .html files too, and would like confirmation that that was
the right thing to do.

Does not look like any html files in this pull request. Do you mean the .rst files?

Apparently the files in _build/html/... are not under git control. I'm guessing those are exclude intentionally.

[hkershaw-brown]

Apparently the files in _build/html/... are not under git control. I'm guessing those are exclude intentionally.

Yes those are files from the local build of the documentation.

[hkershaw-brown]

How about for the .rst having one reference file for all the data sets so they only need to be changes in one place (when the rda links change, or change to dois).

.. CAM6rean :: https://rda.ucar.edu/datasets/d345000/

.. CAM4rean :: https://rda.ucar.edu/datasets/whatever

.. NCEPrda :: https://rda.ucar.edu/datasets/blahblah

[kdraeder]

How about for the .rst having one reference file for all the data sets so they only need to be changes in one place (when the rda links change, or change to dois).

.. CAM6rean :: https://rda.ucar.edu/datasets/d345000/

.. CAM4rean :: https://rda.ucar.edu/datasets/whatever

.. NCEPrda :: https://rda.ucar.edu/datasets/blahblah

That would tidy some of the files nicely. But most of the files are stream files.
I'll work on it.

[hkershaw-brown]

Add this to conf.py them you can have a guide/references.rst (or whatever you want to call it) included in every file. This means you can use CAM6rean_ anywhere in the docs.

 89 # include references
 90 with open(os.path.join(os.path.dirname(__file__), 'guide/references.rst')) as f:
 91     references_content = f.read()
 92 
 93 rst_prolog = references_content