more information regarding PLUMBER 2 simulations using the ./runtower…

[ijaguirre]

Description of changes

More documentation for the PLUMBER 2 option using the newly developed ./run_tower tool created by @TeaganKing

Specific notes

Contributors other than yourself, if any:

CTSM Issues Fixed (include github issue #):
Related to #2997

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

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

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

Testing performed, if any: None

[TeaganKing]

Thanks so much for putting this together, @ijaguirre !

I have a few clarifying questions for you, and am happy to address the other changes myself if they seem reasonable to you! If you could just answer a few of the questions and thumbs up the comments if you agree with them, or of course share other thoughts, I'm happy to wrap this up!

[ekluzek]

I'm rebasing the PR to come to b4b-dev. We may also need to rebase the branch itself, depending on where it's at.

[TeaganKing]

I'm rebasing the PR to come to b4b-dev. We may also need to rebase the branch itself, depending on where it's at.

Thanks @ekluzek ! I think that the branch itself should be fine, at least with regards to this documentation file. I don't think the file has been otherwise updated recently.

[wwieder]

@ijaguirre have you been able to make the changes / clarifications that @TeaganKing requested?

[ijaguirre]

Dear @TeaganKing, I apologize for the delay with the corrections. I made all the changes you asked for. If you have any more comments, I'll make sure to update the notes within 1-2 days.

Warm regards,
Ignacio

[ijaguirre]

Dear Will and Teagan Following Will's email, I have updated the documentation based on Teagan's comments. I can implement any suggested changes quickly. Warm regards Ignacio

…

On Mon, Jan 5, 2026 at 5:30 PM will wieder ***@***.***> wrote: *wwieder* left a comment (ESCOMP/CTSM#3305) <#3305 (comment)> @ijaguirre <https://github.com/ijaguirre> have you been able to make the changes / clarifications that @TeaganKing <https://github.com/TeaganKing> requested? — Reply to this email directly, view it on GitHub <#3305 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AE5SEM3BST3CDP3455P2D7D4FKNTFAVCNFSM6AAAAACA4TIZROVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTOMJRGM4TONJTGI> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[ijaguirre]

Dear all,

I added further information and an example.

[slevis-lmwg]

Thank you @ijaguirre
I will go through and mark all conversations "resolved"

[slevis-lmwg]

I found evidence of (some of) the errors by clicking "View details" and scrolling through the many lines:

/home/user/mounted_home/doc/source/users_guide/running-single-points/supported-tower-sites.rst:81: ERROR: Unexpected indentation. [docutils]
/home/user/mounted_home/doc/source/users_guide/running-single-points/supported-tower-sites.rst:92: WARNING: Enumerated list ends without a blank line; unexpected unindent. [docutils]
/home/user/mounted_home/doc/source/users_guide/running-single-points/supported-tower-sites.rst:94: ERROR: Unexpected indentation. [docutils]
/home/user/mounted_home/doc/source/users_guide/running-single-points/supported-tower-sites.rst:98: WARNING: Enumerated list ends without a blank line; unexpected unindent. [docutils]
/home/user/mounted_home/doc/source/users_guide/running-single-points/supported-tower-sites.rst:100: ERROR: Unexpected indentation. [docutils]

@ijaguirre could you look into resolving?

[ijaguirre]

Dear Samuel Definitely, I will look into this. Is there a user guide to edit the documentation? I am especially interested in addressing the "Unexpected indentation" issue. Thank you Warm Regards Ignacio

…

On Wed, Mar 18, 2026 at 8:14 PM Samuel Levis ***@***.***> wrote: *slevis-lmwg* left a comment (ESCOMP/CTSM#3305) <#3305 (comment)> I found evidence of (some of) the errors by clicking "View details" and scrolling through the many lines: /home/user/mounted_home/doc/source/users_guide/running-single-points/supported-tower-sites.rst:81: ERROR: Unexpected indentation. [docutils] /home/user/mounted_home/doc/source/users_guide/running-single-points/supported-tower-sites.rst:92: WARNING: Enumerated list ends without a blank line; unexpected unindent. [docutils] /home/user/mounted_home/doc/source/users_guide/running-single-points/supported-tower-sites.rst:94: ERROR: Unexpected indentation. [docutils] /home/user/mounted_home/doc/source/users_guide/running-single-points/supported-tower-sites.rst:98: WARNING: Enumerated list ends without a blank line; unexpected unindent. [docutils] /home/user/mounted_home/doc/source/users_guide/running-single-points/supported-tower-sites.rst:100: ERROR: Unexpected indentation. [docutils] @ijaguirre <https://github.com/ijaguirre> could you look into resolving? — Reply to this email directly, view it on GitHub <#3305 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AE5SEM5YOIOZ3Y6M7EKJ7IL4RL7SZAVCNFSM6AAAAACA4TIZROVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DAOBVGMYTANJYGE> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[samsrabin]

@ijaguirre Here is our User Guide section on working with the documentation. It includes some specific guidance on the "unexpected indentation" error, as well as a different "unexpected indent" error.

[slevis-lmwg]

Yay, I got it all to work after some trial and error...