Skip to content

Polish README against rubygem README rubric - #2

Merged
bigtiger merged 1 commit into
oss-readinessfrom
readme-review-polish
May 16, 2026
Merged

bigtiger merged 1 commit into
oss-readinessfrom
readme-review-polish

Conversation

@bigtiger

Copy link
Copy Markdown
Contributor

Summary

  • Synopsis rewritten to state mechanism, em-dash commas removed.
  • Install gains Gemfile snippet form; Quick start documents # => nil return and DeliveryError semantics.
  • Custom channel example uses keyword arg parity with Slack.new(webhook_url:) and a runnable Net::HTTP call instead of pseudocode.
  • Sidekiq example notes that PageLoadError#report carries the partial report.
  • Added Documentation, Contributing, Code of Conduct, and Supported Ruby versions sections; License now links LICENSE.txt.
  • Dropped emoji from custom-formatter example; bare GitHub URL linkified.

Test plan

  • Render README on GitHub and verify all anchors/links resolve (LICENSE.txt, CONTRIBUTING.md, CODE_OF_CONDUCT.md, CHANGELOG.md, doc/adr, .github/workflows/ci.yml).
  • Verify badges still resolve.
  • Verify the WebhookChannel example syntax (manual ruby -c of the snippet).

Apply review findings against the authoring-rubygem-readmes rubric:
synopsis states mechanism instead of marketing, install shows Gemfile
form first, Quick start documents the return value, custom channel
example uses keyword args and real Net::HTTP, Sidekiq example annotates
PageLoadError#report, and the file gains Documentation, Contributing,
Code of Conduct, and Supported Ruby versions sections. License now
links LICENSE.txt.
@bigtiger
bigtiger merged commit 3094bf0 into oss-readiness May 16, 2026
1 check passed
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.

1 participant