Skip to content

Improve CONTRIBUTING.rdoc#1358

Closed
ybiquitous wants to merge 1 commit intoruby:masterfrom
ybiquitous:improve-doc-contributing
Closed

Improve CONTRIBUTING.rdoc#1358
ybiquitous wants to merge 1 commit intoruby:masterfrom
ybiquitous:improve-doc-contributing

Conversation

@ybiquitous
Copy link
Copy Markdown
Contributor

@ybiquitous ybiquitous commented May 3, 2025

This fixes some trivial mistakes in the CONTRIBUTING document without changing the content largely.

  • Fix typos
  • Add commas for readability
  • Fix grammar mistakes
  • Fix broken links
  • Use monospace font (+ or <tt>) where necessary

The current published page: https://ruby.github.io/rdoc/CONTRIBUTING_rdoc.html

This fixes some trivial mistakes in the CONTRIBUTING document without changing the content largely.

- Fix typos
- Add commas for readability
- Fix grammar mistakes
- Fix broken links
- Use monospace font where necessary
Comment thread CONTRIBUTING.rdoc
parsing class must respond to \::parse and accept a String argument containing
the markup format. An RDoc::Document containing documentation items
parsing class must respond to +::parse+ and accept a String argument containing
the markup format. An RDoc::Markup::Document containing documentation items
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

[note] RDoc::Document doesn't exist now. I probably RDoc::Markup::Document is correct.

Comment thread CONTRIBUTING.rdoc
the markup format. An RDoc::Document containing documentation items
parsing class must respond to +::parse+ and accept a String argument containing
the markup format. An RDoc::Markup::Document containing documentation items
(RDoc::Markup::Heading, RDoc::Markup::Paragraph, RDoc::Markup::Verbatim, etc.)
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

[note] RDoc::Markup::Heading exists but isn't rendered as a link in HTML. This seems like a bug, but I'm not sure about the details. 🤔

RDoc::Markup::Heading =

image

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Similarly, RDoc::Text::MARKUP_FORMAT is also not rendered as a link, regardless of its existence.

RDoc::Text::MARKUP_FORMAT hash like:

MARKUP_FORMAT = {

image

@ybiquitous ybiquitous marked this pull request as ready for review May 3, 2025 08:12
@ybiquitous
Copy link
Copy Markdown
Contributor Author

One failure on CI is caused by the Ruby installation. It seems like a temporary issue (re-run can recover?).

Copy link
Copy Markdown
Member

@kou kou left a comment

Choose a reason for hiding this comment

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

+1

@ybiquitous
Copy link
Copy Markdown
Contributor Author

CONTRIBUTING.rdoc was renamed to CONTRIBUTING.md via PR #1496. I'm closing this PR.

@ybiquitous ybiquitous closed this Apr 27, 2026
@ybiquitous ybiquitous deleted the improve-doc-contributing branch April 27, 2026 12:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants