Skip to content

docs: clarify help output and docstring - #1129

Merged
Shorla merged 1 commit into
swcarpentry:mainfrom
MahishaKannan:fix-issue-1125
Oct 13, 2026
Merged

Shorla merged 1 commit into
swcarpentry:mainfrom
MahishaKannan:fix-issue-1125

Conversation

@MahishaKannan

Copy link
Copy Markdown

Summary

  • Clarify the distinction between the output of help() and a function's documentation.
  • Keep the wording beginner-friendly and limited to the existing explanation.

Closes #1125

@github-actions

github-actions Bot commented Oct 9, 2026 •

Copy link
Copy Markdown
Contributor

Thank you!

Thank you for your pull request 😃

🤖 This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}.

If you have files that automatically render output (e.g. R Markdown), then you should check for the following:

  • 🎯 correct output
  • 🖼️ correct figures
  • ❓ new warnings
  • ‼️ new errors

Rendered Changes

🔍 Inspect the changes: https://github.com/swcarpentry/python-novice-inflammation/compare/md-outputs..md-outputs-PR-1129

The following changes were observed in the rendered markdown documents:

 01-intro.md | 2 +-
 md5sum.txt  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
What does this mean?

If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible.

This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation.

⏱️ Updated at 2026-10-13 15:15:49 +0000

@Shorla

Shorla commented Oct 13, 2026

Copy link
Copy Markdown
Contributor

Hi @MahishaKannan, thank you so much for taking the time to work on this issue.

@noatgnu @ineelhere, I want a second opinion before merging this PR.

@noatgnu

noatgnu commented Oct 13, 2026

Copy link
Copy Markdown
Contributor

Should be ok to merge for me @Shorla

@MahishaKannan

Copy link
Copy Markdown
Author

Ok it's your wish if you want to merge @Shorla ok for me but I think I worked for it it's ok

@Shorla

Shorla commented Oct 13, 2026

Copy link
Copy Markdown
Contributor

Should be ok to merge for me @Shorla

Thank you! @noatgnu

@Shorla
Shorla merged commit c789bb6 into swcarpentry:main Oct 13, 2026
5 checks passed
github-actions Bot pushed a commit that referenced this pull request Oct 13, 2026
Auto-generated via `{sandpaper}`
Source  : c789bb6
Branch  : main
Author  : Olushola Ogunkelu <sogunkelu@gmail.com>
Time    : 2026-10-13 16:31:53 +0000
Message : Merge pull request #1129 from MahishaKannan/fix-issue-1125

docs: clarify help output and docstring
github-actions Bot pushed a commit that referenced this pull request Oct 13, 2026
Auto-generated via `{sandpaper}`
Source  : 54e7258
Branch  : md-outputs
Author  : GitHub Actions <actions@github.com>
Time    : 2026-10-13 16:33:29 +0000
Message : markdown source builds

Auto-generated via `{sandpaper}`
Source  : c789bb6
Branch  : main
Author  : Olushola Ogunkelu <sogunkelu@gmail.com>
Time    : 2026-10-13 16:31:53 +0000
Message : Merge pull request #1129 from MahishaKannan/fix-issue-1125

docs: clarify help output and docstring
github-actions Bot pushed a commit that referenced this pull request Oct 20, 2026
Auto-generated via `{sandpaper}`
Source  : 54e7258
Branch  : md-outputs
Author  : GitHub Actions <actions@github.com>
Time    : 2026-10-13 16:33:29 +0000
Message : markdown source builds

Auto-generated via `{sandpaper}`
Source  : c789bb6
Branch  : main
Author  : Olushola Ogunkelu <sogunkelu@gmail.com>
Time    : 2026-10-13 16:31:53 +0000
Message : Merge pull request #1129 from MahishaKannan/fix-issue-1125

docs: clarify help output and docstring
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Clarify the distinction between help() output and a function's docstring

3 participants