Skip to content

Documentation updates: New hist time handling#3837

Open
slevis-lmwg wants to merge 4 commits intoESCOMP:b4b-devfrom
slevis-lmwg:new_hist_time_handling
Open

Documentation updates: New hist time handling#3837
slevis-lmwg wants to merge 4 commits intoESCOMP:b4b-devfrom
slevis-lmwg:new_hist_time_handling

Conversation

@slevis-lmwg
Copy link
Contributor

@slevis-lmwg slevis-lmwg commented Mar 24, 2026

Description of changes

In the same doc locations where I had previously mentioned the h0a/h0i distinction, I now include explanations of the new time handling; namely, mid-point of time bounds for h0a and time step for h0i.

I also updated the What Is New section to include links to all WhatsNew files. This was necessary regardless, and it simultaneously addresses the need to mention the elimination of the 0th time step in our simulations. I consider the latter a subtle enough change with no tangible effect on users that we should not need separate mention in the User's Guide or Technote.

Specific notes

Contributors other than yourself, if any:

CTSM Issues Fixed (include github issue #):
Fixes #3171

Are answers expected to change (and if so in what way)?
No

Any User Interface Changes (namelist or namelist defaults changes)?
No

Purpose: To update doc/source/users_guide/overview/introduction.rst with WhatsNewInCTSM5.4.md in its permanent location
@slevis-lmwg slevis-lmwg self-assigned this Mar 24, 2026
@slevis-lmwg slevis-lmwg added documentation additions or edits to user-facing documentation or its infrastructure bfb bit-for-bit docs:minor-content-fix Small fix needed to (or improvement suggested in) documentation content docs-loc:users-guide Relates to User's Guide (using CTSM/tools) labels Mar 24, 2026
@github-project-automation github-project-automation bot moved this to Ready to start (or start again) in CTSM: Upcoming tags Mar 24, 2026
@slevis-lmwg slevis-lmwg moved this to In Progress in CLM documentation Mar 24, 2026
@slevis-lmwg slevis-lmwg moved this from Ready to start (or start again) to In progress - b4b-dev in CTSM: Upcoming tags Mar 24, 2026
@slevis-lmwg slevis-lmwg moved this from Todo to In Progress in LMWG: Sprint Planning Board Mar 24, 2026
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To clarify what I did here, starting from the original location of the WhatsNewInCTSM5.4.md file:

git mv WhatsNewInCTSM5.4.md doc/.
cd ..
ln -s doc/WhatsNewInCTSM5.4.md .
git add WhatsNewInCTSM5.4.md
git commit

...and this was the first commit of this PR: 85c7be2

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To clarify why:

  • I wanted all WhatsNew files in their final locations before adding links to them
  • The WhatsNew files discuss the new history time handling in greater detail that I find necessary for the User's Guide and Technote

@slevis-lmwg
Copy link
Contributor Author

For the review, I will ask Erik, Sam R., and Will, and you can decide who's most interested :-)

@slevis-lmwg slevis-lmwg moved this from In Progress to In review in CLM documentation Mar 24, 2026
@slevis-lmwg slevis-lmwg linked an issue Mar 24, 2026 that may be closed by this pull request
8 tasks
@samsrabin samsrabin added the next this should get some attention in the next week or two. Normally each Thursday SE meeting. label Mar 24, 2026
@samsrabin
Copy link
Member

Added "next" to discuss reviewer assignment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bfb bit-for-bit docs:minor-content-fix Small fix needed to (or improvement suggested in) documentation content docs-loc:users-guide Relates to User's Guide (using CTSM/tools) documentation additions or edits to user-facing documentation or its infrastructure next this should get some attention in the next week or two. Normally each Thursday SE meeting.

Projects

Status: In review
Status: In progress - b4b-dev
Status: In Progress

Development

Successfully merging this pull request may close these issues.

Docs needed: New history time handling

2 participants