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

[DOC] Mods about markup formats #1143

Merged
merged 2 commits into from
Jul 29, 2024
Merged

[DOC] Mods about markup formats #1143

merged 2 commits into from
Jul 29, 2024

Conversation

BurdetteLamar
Copy link
Member

Clarifies (I hope) some things about markup formats.

I've purposely not mentioned markup as an alias for rdoc because I think it invites confusion.

#
# - +rdoc+:
# the +RDoc+ markup format;
# see RDoc::Markup.
Copy link
Member

Choose a reason for hiding this comment

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

Doesn't this just link to the current file? There's not much information on that file. Isn't it more useful to link to MarkupReference?

Copy link
Member Author

Choose a reason for hiding this comment

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

Not to the current file (RDoc/Markup.html), but to RDoc/Markdown.html. This bullet item is about markdown, not markup.

Copy link
Member

Choose a reason for hiding this comment

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

I'm confused. This bullet point is for RDoc markup, not markdown.

Copy link
Member Author

Choose a reason for hiding this comment

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

Duh. I'm the one who was confused. Now fixed to refer to RDoc::MarkupReference.

@peterzhu2118 peterzhu2118 merged commit 011de3f into ruby:master Jul 29, 2024
23 checks passed
matzbot pushed a commit to ruby/ruby that referenced this pull request Jul 29, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

Successfully merging this pull request may close these issues.

2 participants