Skip to content

Commit 730f03f

Browse files
committed
docs: development instructions
1 parent 4f6ef06 commit 730f03f

File tree

2 files changed

+56
-0
lines changed

2 files changed

+56
-0
lines changed

Development.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# Development
2+
3+
## Getting Started
4+
5+
In order to contribute a bug fix or a feature, follow these steps:
6+
7+
1. Fork the repository
8+
9+
2. Make a branch for your fix or feature
10+
11+
3. When you've tested out your fix or new feature, commit using commit message guidelines as listed below.
12+
13+
4. Submit a Pull Request to the main github repository (that you initially cloned from).
14+
15+
5. Celebrate! :tada:
16+
17+
## Commit Message Guidelines
18+
19+
To make package deployment easier, we've opted to use Travis CI to deploy and version our package. When a PR is merged into master, it looks at all of the commits since the last release and figures out what the new version should be and then releases. In order to figure out what the next version should be, we need to use a commit message format that allows us to indicate how the commit affects the code base.
20+
21+
### Format
22+
23+
The format we follow is:
24+
25+
"[type]: [message]
26+
27+
[optional description]
28+
29+
[optional footer]"
30+
31+
*Type*: Here are the types available and when they should be used:
32+
33+
| Type | Effect | Used for |
34+
|------|--------|----------|
35+
| fix | Creates a patch release | Bug fixes that don't break the public API |
36+
| feat | Creates a minor release | Features added that don't break the public API |
37+
| BREAKING CHANGE | Creates a major release (this is only used after we reach 1.0) | Features or bug fixes that require breaking changes |
38+
| chore | Does not make a release | Development work that doesn't affect the core package functionality |
39+
40+
Please checkout the [conventional commits](https://www.conventionalcommits.org/en/v1.0.0-beta.3/#summary) to find more types and what they do.
41+
42+
*Message*: can be anything you want. Start with a lower case. Limit the first line (type and message) to 50 chars.
43+
44+
*Description*: try to describe _why_ your change was needed rather than _what_ your change was (we can see that in the code). Wrap lines at 72 chars.
45+
46+
*Footer*: If your bug fix or feature is related to a github issue, this is where you would link it. For example, `Fixes: #1`.
47+
48+
### More Info
49+
50+
**Semantic Releases**: https://github.com/semantic-release/semantic-release
51+
**Commit Message Format**: https://www.conventionalcommits.org/en/v1.0.0-beta.3/#summary
52+
**Commit Message Best Practices**: https://chris.beams.io/posts/git-commit/

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,3 +18,7 @@ A replacement of the definitions functionality from the original Atom-IDE / Nucl
1818
* Rust [ide-rust](hhttps://atom.io/packages/ide-rust)
1919

2020
You can also search for [packages](https://atom.io/packages/search?q=IDE) in Atom.
21+
22+
## Development
23+
24+
Please see [Development.md](./Development.md)

0 commit comments

Comments
 (0)