run_tower and run_tower.py docstrings have drifted

Open Beginner friendly
#4,306 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
65/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
fortran
Domain
documentation

Research direction

Find the run_tower and run_tower.py docstrings and compare their overlapping content. Start by reading both; the issue suggests trimming the wrapper's docstring to reduce duplicated information. Done means the two docstrings no longer duplicate confusing information and accurately direct readers to the relevant details.

Written by the indexing model from the issue text.

Description

b4b docs-loc:codebase docs:minor-content-fix documentation

(Please see our contribution guidelines for documentation.)

What sort(s) of documentation issue is this?
  • Something is missing.
  • Something is (or might be) incorrect or outdated.
  • Something is confusing.
  • Something is broken.
What part(s) of the documentation does this concern?
  • Technical Note (science and design of the model)
  • User's Guide (using the model and related tools)
  • Somewhere else (e.g., README file, tool help text, or code comment): Please specify
  • I don't know
Describe the issue

The run_tower and run_tower.py docstrings have drifted. There is lots of duplicated information, making this easy to happen. I suggest trimming from run_tower, which is just a wrapper.

Dominant language
Fortran
Stars
353
Forks
368
Avg merge
2d 15h
Merged PRs (30d)
12

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from ESCOMP/CTSM

All issues in ESCOMP/CTSM

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.