Pull Request Tags

Prev Next

Rocket.Chat encourages contributions from developers worldwide. One of the primary ways to contribute is through pull requests (PRs). PRs are a critical part of maintaining and improving the software, and they can range from bug fixes to the addition of new features. However, it's essential to follow specific guidelines when submitting a PR to ensure clarity and ease of understanding for the reviewers.

This guide provides a succinct overview of the best practices for creating PRs for Rocket.Chat.

These PR tags can include:

feat|fix|ci|chore|docs|test|refactor|i18n|regression|revert

Here's a brief explanation of each:

PR Tag

Description

Bad example

Good example

feat:

Use this tag when adding a new feature that is significant to the end-user.

The title should describe what’s being added, not how it was added, and shouldn’t start with Add ..., New ..., or Feature ....

  • feat: Add the ability to set tags in the Omnichannel room closing dialog

  • feat: Adds the ability for Rocket.Chat Apps to create discussions

  • feat: Add MMS support to Voxtelesys

  • feat: Add Color variable to the left sidebar

  • feat: Ability to set tags in the Omnichannel room closing dialog

  • feat: Ability for Rocket.Chat Apps to create discussions

  • feat: MMS support to Voxtelesys

  • feat: Color variable to the left sidebar

fix:

This tag is for fixing something not working or behaving incorrectly from the end-user perspective.

The title should describe what's being fixed, not how it was fixed.

  • fix: Add Content-Type for public files with JWT

  • fix: Missing Content-Type header for public files with JWT

chore:

Use this for small tasks such as changing a function name or something very quick that doesn't fit in another category.

The title should describe what's being changed, not how it was changed.

  • chore: Renaming `getNewMessage` function and replacing it in all files that use this function

  • chore: Rename `getNewMessage` function

docs:

This tag is for documentation such as README.md files, and other markdown and instruction files that bring value to the community.

The title should describe what's being changed, not how it was changed.

  • docs: Update Pull Request Template

refactor:

Use this for a code refactor that doesn't change behavior (it doesn't add anything and doesn't fix anything) such as converting a JavaScript file to TypeScript.

  • refactor: RoomInfo to typescript

ci:

This tag is for changes that update or add a CI configuration.

  • ci: PR title check to use conventional commits

test:

This tag is for adding tests.

  • test: RoomInfo e2e tests

i18n:

Use this for updating or adding any translations.

  • i18n: Homepage translations to pt-BR

regression:

This tag is for changes made during any release candidate cycle to add something missing or fix something broken during the last development cycle and not published to a final release yet.

  • regression: Fix not being able to mark room as read

  • regression: Add missing field to `users` endpoint

revert:

Use this tag when undoing a change that was previously merged. The title should name the change being reverted.

  • revert: Phishing resistant multi factor authentication

Contributing to Rocket.Chat through pull requests is a valuable way to improve the platform and engage with the open-source community. By following these guidelines for PR tags, contributors can ensure their work is understood and appreciated by the Rocket.Chat team and the broader community.

Remember, the key is to describe what's being changed, fixed, or added, not how it was done. Happy contributing!