docs: upgrading documentation

This commit is contained in:
André Neves 2018-11-23 14:03:55 -05:00
parent 68d781002a
commit 340ca7d02f
2 changed files with 60 additions and 0 deletions

60
DEVELOPMENT_WORKFLOW.md Normal file
View File

@ -0,0 +1,60 @@
# Development Workflow
This repository follow the GitFlow paradigm. If you are unfamiliar with GitFlow, please read [Atlassian's GitFlow documentation](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow) illustrating the concepts and its advantages.
# Branching
The following lists the branching semantics to follow:
* feature: describes a new feature being implemented
* `example: feature/list-component`
* refactor: describes the refactoring of a portion of the application
* `example: refactor/data-fetch-action`
* hotfix: describes a bugfix
* `example: hotfix/header-scroll-bug`
## Commit Messages
Commit messages should have semantic meanings to make it more easily possible to comb through commits. The following are commit types to follow.
* **feature**: New feature
* **hotfix**: Bug fixes
* **docs**: Documentation-only changes
* **chore**: General code changes not directly related to app functionality
* **style**: Changes to CSS / SCSS
* **lint**: Code formatting and style
* **test**: Test-only changes
* **refactor**: Code change that neither fixes a bug nor adds a feature
* **perf**: Refactor with significant performance benefits
* **ci**: Build system, CI, or CD pipeline changes
* **revert**: Commits which revert another commit
* **type**: Changes specific to static * types (TypeScript, Flow, etc...)
Commits should be isolated to one type. Make sure to keep commits small. This Will help to easily change or revert back to past commits. Additionally, commits can have multi-line messages to better express the commit.
```
docs: commit messages doc
- Add COMMIT_MESSAGES.md
reflecting the structure and conventions for commit messages.
- Write bullet points explaining the docs
- Show an example commit
```
## Pull Requests
When it comes time to open a PR, make sure that the PR covers all development in the current ticket being worked on. Do your due diligence and make sure everything is working to the best of your knowledge, on every operating system you can test on. If everything is good to go a PR may be opened.
#### Title
The title of the PR should have the type shown (feature, hotfix, chore, etc..) as well as a brief description of the PR's purpose. If this PR relates directly to a ticket (as they ideally should), add the ticket number in as well. Example
`[feature] [ZC-12] Add Infinite Scroll`
In some cases there may be a reason that a PR should be opened for discussion among all engineers. If this is the case you should prefix your PR's with [WIP] Example
`[WIP] [feature] [ZC-12] Add Infinite Scroll`
## Linting
All prjects containing Javascript must be linted. This helps us deliver clean and uniform code. ESLint will be the linter used on all projects, and `.eslintrc` file will provide the linting rules to follow.

View File