Skip to content

Docs docs: Add instructions for embedding files in docs#3982

Merged
samsrabin merged 3 commits intoESCOMP:b4b-devfrom
samsrabin:docs-docs-embedding
May 7, 2026
Merged

Docs docs: Add instructions for embedding files in docs#3982
samsrabin merged 3 commits intoESCOMP:b4b-devfrom
samsrabin:docs-docs-embedding

Conversation

@samsrabin
Copy link
Copy Markdown
Member

Description of changes

Adds instructions for embedding reStructuredText files within other reStructuredText files, and Markdown files within other Markdown files.

Specific notes

Contributors other than yourself, if any: None

CTSM Issues Fixed:

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

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

Does this create a need to change or add documentation? Did you do so? n/a

Testing performed, if any: Doc build tests and previews.

@samsrabin samsrabin self-assigned this Apr 30, 2026
@samsrabin samsrabin added documentation additions or edits to user-facing documentation or its infrastructure b4b bit-for-bit docs:new New documentation needed (e.g., for a new feature) docs-loc:users-guide Relates to User's Guide (using CTSM/tools) labels Apr 30, 2026
@samsrabin samsrabin moved this to In Progress in CLM documentation Apr 30, 2026
@samsrabin samsrabin added PR status: awaiting review Work on this PR is paused while waiting for review. next this should get some attention in the next week or two. Normally each Thursday SE meeting. labels Apr 30, 2026
@samsrabin samsrabin requested a review from wwieder April 30, 2026 16:22
@samsrabin samsrabin removed the next this should get some attention in the next week or two. Normally each Thursday SE meeting. label Apr 30, 2026
@samsrabin samsrabin moved this from In Progress to In review in CLM documentation Apr 30, 2026
@ekluzek ekluzek self-requested a review May 4, 2026 16:19
Copy link
Copy Markdown
Contributor

@wwieder wwieder left a comment

Choose a reason for hiding this comment

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

These are helpful examples and it seems to render fine too.

Minor editorial suggestions you can decide on, Sam, but I don't feel like I need to review this again.

Comment thread doc/source/users_guide/working-with-documentation/embed-example-markdown.md Outdated
Comment thread doc/source/users_guide/working-with-documentation/embed-example-rst.rst Outdated
Comment thread doc/source/users_guide/working-with-documentation/embed-example-rst.rst Outdated
samsrabin and others added 2 commits May 7, 2026 08:26
Co-authored-by: will wieder <wwieder@ucar.edu>
Co-authored-by: Sam Rabin <samrabin@ucar.edu>
@samsrabin samsrabin merged commit 7d1b343 into ESCOMP:b4b-dev May 7, 2026
5 checks passed
@github-project-automation github-project-automation Bot moved this from In review to Done in CLM documentation May 7, 2026
@slevis-lmwg slevis-lmwg mentioned this pull request May 7, 2026
3 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

b4b bit-for-bit docs:new New documentation needed (e.g., for a new feature) docs-loc:users-guide Relates to User's Guide (using CTSM/tools) documentation additions or edits to user-facing documentation or its infrastructure PR status: awaiting review Work on this PR is paused while waiting for review.

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

User's Guide: Docs docs: Add instructions for embedding (parts of) a file in reStructuredText/Markdown

2 participants