forked from RocketChat/docs-old
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add documentation draft guides (RocketChat#727)
* Add documentation draft guides * Fix lint
- Loading branch information
1 parent
95d353d
commit f6944ab
Showing
5 changed files
with
64 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
# Documentation 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` with 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 Draft](new-feature-draft/) | ||
- [Feature Change Draft](feature-change-draft/) |
29 changes: 29 additions & 0 deletions
29
contributing/documentation/drafts/feature-change-draft/README.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,29 @@ | ||
# Feature Change Documentation Draft Template | ||
|
||
If you created a pull request and believe that it could change something already documented, use this template to create a draft for the documentation. | ||
|
||
Firstly to check if the feature you are working on is already documented, you can take a look in the documentation map (<https://rocket.chat/docs/contributing/documentation/documentation-map/>), that is a list with all the articles and their current status. Alternatively you can use the search bar on our documentation website (<https://rocket.chat/docs/>). | ||
|
||
To submit a draft, create a pull request(make sure you are doing from a branch in the repository) and tag it as 'draft', after that the documentation team will edit it to suit the documentation standard. | ||
|
||
The draft serves to give information to the documentation team so they can create the appropriate documentation for that feature. | ||
|
||
When a feature is changed, its very important to update the documentation, the lack of this custom can lead to outdated and invalid documentation quickly. | ||
|
||
_Note 1: the template is not absolute, and in some cases it might not make sense to follow the template by the letter. If a field can't be answered you can leave it as "N/A"_ | ||
|
||
_Note 2: sometimes creating a pull request and doing the fix to the docs can be faster than creating a draft (especially in small changes), so don't be afraid to create a pull request directly to change the docs._ | ||
|
||
``` | ||
# FEATURE NAME | ||
**Changed in version:** <!-- The version that feature was changed --> | ||
**Link to original documentation:** | ||
**Link to pull request:** | ||
**What was changed:** <!-- What have change in the feature? --> | ||
**Has the way to use the feature changed?:** <!-- To use that feature, will the user have to do something different than before? --> | ||
``` |
25 changes: 25 additions & 0 deletions
25
contributing/documentation/drafts/new-feature-draft/README.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,25 @@ | ||
# New Feature Documentation Draft Template | ||
|
||
If you have created a pull request creating a new feature please use this template to create a draft of the documentation. | ||
|
||
To submit a draft, create a pull request(make sure you are doing from a branch in the repository) and tag it as 'draft', after that the documentation team will edit it to suit the documentation standard. | ||
|
||
The draft serves to give information to the documentation team so they can create the appropriate documentation for that feature. | ||
|
||
Please try to be very detailed when writing about the feature, this will help create better documentation. | ||
|
||
_Note: the template is not absolute, and in some cases it might not make sense to follow the template by the letter. If a field can't be answered you can leave it as "N/A"_ | ||
|
||
``` | ||
# FEATURE NAME | ||
**Added in version:** <!-- The version that feature was implemented --> | ||
**Type of feature:** <!-- What type is the feature being created. E.g. API, User Feature, Admin Feature, Development Feature, etc... --> | ||
**Involved settings:** <!-- Does this features adds or changes any setting? Which ones? What do they do? --> | ||
**Description:** <!-- What does this feature do? --> | ||
**How to use this feature:** <!-- How can this feature be used? --> | ||
``` |