Skip to content

More consistent language READMEs - #1483

Merged
brandur merged 1 commit into
masterfrom
brandur-more-consistent-readmes
Oct 10, 2026
Merged

brandur merged 1 commit into
masterfrom
brandur-more-consistent-readmes

Conversation

@brandur

@brandur brandur commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

We have a little problem where the various language READMEs aren't all
doing the same thing. Some contain user instructions, others development
instructions. Here, make them explicitly intended for user-facing docs
and move any internal development content to docs/development.md in
each directory.

Changes:

  • Java: Mostly usage examples already. Moved contributor instructions to
    java/docs/development.md.

  • JavaScript: Similar. Moved API-doc generation command.

  • Ruby: Mostly links and contributor commands. Added installation
    instructions and example. Moved contributor commands.

  • Rust: Most workspace/development workflow. Added installation
    instructions, example, features, and crate links. Move other content.

@brandur
brandur requested a review from bgentry October 8, 2026 06:21
Comment thread java/README.md
Comment on lines +12 to +21
<dependency>
<groupId>com.riverqueue</groupId>
<artifactId>river</artifactId>
<version>0.48.0-alpha.1</version>
</dependency>
<dependency>
<groupId>org.postgresql</groupId>
<artifactId>postgresql</artifactId>
<version>42.7.12</version>
</dependency>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

oh, Java and its XML

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.

Yeah :( They really should've dropped this at some point.

We have a little problem where the various language READMEs aren't all
doing the same thing. Some contain user instructions, others development
instructions. Here, make them explicitly intended for user-facing docs
and move any internal development content to `docs/development.md` in
each directory.

Changes:

* Java: Mostly usage examples already. Moved contributor instructions to
  `java/docs/development.md`.

* JavaScript: Similar. Moved API-doc generation command.

* Ruby: Mostly links and contributor commands. Added installation
  instructions and example. Moved contributor commands.

* Rust: Most workspace/development workflow. Added installation
  instructions, example, features, and crate links. Move other content.
@brandur
brandur force-pushed the brandur-more-consistent-readmes branch from 579544d to 6944737 Compare October 10, 2026 04:09
@brandur
brandur merged commit a6d1393 into master Oct 10, 2026
61 checks passed
@brandur
brandur deleted the brandur-more-consistent-readmes branch October 10, 2026 04:36
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