Documenting

First of all, thank you for your interest in contributing to Rocket.Chat Docs. If this is the first Open Source project you will contribute to, we strongly suggest reading GitHub's excellent guide:
How to Contribute to Open Source
Open Source Guides
Finding something to work on
You can find a list of issues here. When you find something you would like to work on just comment on it and we will add an In Progress label.
Creating a new Pull Request
Requirements
When you create a new pull request, we expect some requirements to be met.
Follow this naming convention for Pull Requests:
When adding new documentation, add New Documentation: before the title. E.g. New Documentation: Authentication Guide
When fixing documentation, add Fix Documentation: before the title. E.g. Fix Documentation: Authentication Guide
When updating documentation, add Update Documentation: before the title. E.g. Update Documentation: Authentication Guide
If your Pull Request closes an issue you need to write Closes #ISSUE_NUMBER where the ISSUE_NUMBER is the number at the end of the link URL that will link your pull request to the issue, when merged will close that issue.
For each pull request made, we run tests to check if there are any broken links. You can find how to run these tests locally here.
Creating Drafts
When you create a new feature but for some reason can't create a full-fledged documentation pull request, you can create a draft which is a single file pull request with critical information needed to create the desired documentation, after creating the draft, the documentation team will edit the pull request to suit the documentation standards.
​New Feature Template​
​Feature Change Template​
Testing Changes
To test your changes you have 2 options:
OPTION 1: Fork and use GitBook
Simply fork our docs repository, create a space and activate the GitHub Integration on your fork.
OPTION 2: Run it locally
We do not recommend this method since GitBook CLI is deprecated and it takes a long time to build.
When making small changes like typos and such, there is no problem editing the file directly on GitHub, but if you are making bigger changes or adding new files to the docs, we recommend following this workflow
Install GitBook's client package using NPM.
1
npm install -g gitbook-cli
Copied!
After that you need to build the documentation, from the root of the docs folder do:
1
gitbook build .
Copied!
This will generate a folder called "_book" with the built docs.
Then serve the buildt book using:
1
gitbook serve .
Copied!
This will serve the book to the url http://localhost:4000/
Find out more on GitBook Cli's repository​
Community Maintainers
We are looking for community maintainers for the Rocket.Chat documentation. Maintainers will be added to a special team with write permissions. These permissions consist of opening, closing, tagging, and editing issues and pull requests, create and delete non-protected branches on the docs repository.
The responsibilities of a maintainer are:
Issue Triage
Labeling issues: Label issues accordingly.
Finding Duplicates: finding and closing duplicate issues.
Closing irrelevant/inappropriate issues: Closing issues that are no longer needed, that are not relevant to the project, and/or don't follow the issues guidelines.
Doing first-level contact: Getting more information on the issues (like version number or asking for clarification) and closing them if they aren't relevant or if a question made by the maintainer wasn't answered in 2 days.
Help with Contribution
Help Manage Pull Requests: help the author of the pull request with any problems (like tests failing due to markdown problems on the pull request)
Contributing! Create pull requests to help maintain the documentation

Developing

New Feature Template

Last modified 25d ago

Export as PDF

Copy link

Contents

Finding something to work on

Creating a new Pull Request

Requirements

Creating Drafts

Testing Changes

Community Maintainers

Issue Triage

Help with Contribution