Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: --help was being represented incorrectly... #2213

Merged
merged 1 commit into from
Sep 11, 2024

Conversation

vwheeler63
Copy link
Collaborator

@vwheeler63 vwheeler63 commented Sep 11, 2024

...on page https://www.writethedocs.org/guide/writing/docs-principles/ because the `` directive was not being parsed by sphinx inside an italics paragraph just under the "Principles for publications" heading.

This was fixed by terminating the italics block and re-starting it just before and after the --help respectively. It now appears as originally intended.

No issue was created about this.


📚 Documentation preview 📚: https://writethedocs-www--2213.org.readthedocs.build/

...on page `https://www.writethedocs.org/guide/writing/docs-principles/`
because the \`\` directive was not being parsed by `spinx` inside an
italics paragraph just under the "Principles for publications" heading.

This was fixed by terminating the italics block and re-starting it just
before and after the ``--help`` respectively.  It now appears as
originally intended.
Copy link
Contributor

@plaindocs plaindocs left a comment

Choose a reason for hiding this comment

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

Thanks @vwheeler63 !!

@vwheeler63
Copy link
Collaborator Author

vwheeler63 commented Sep 11, 2024

Thanks @vwheeler63 !!

My pleasure! I hadn't realized up until a few days ago that there was even a technical-writers community -- on GitHub no less! And the write-the-docs website is rich with ideas and tech-writing (especially code documentation) principles. My tail is wagging, to be sure!

@plaindocs plaindocs merged commit e58ba7c into writethedocs:main Sep 11, 2024
7 checks passed
@vwheeler63
Copy link
Collaborator Author

@plaindocs Wow! I love the fast turn-around! It's already reflected in the on-line website. Bravo!! 🥇 👍

@plaindocs
Copy link
Contributor

Yep, it's one of the truely awesome things about docs as code!

@vwheeler63
Copy link
Collaborator Author

Yep, it's one of the truely awesome things about docs as code!

True that!

@vwheeler63 vwheeler63 deleted the fix/unintended_help_output branch September 11, 2024 14:27
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.

2 participants