Skip to content

Commit 5cc3d89

Browse files
authored
Merge pull request #87 from oneblink/ON-6156
ON-6156 # Added contributing guide
2 parents a2c90cf + eb5936d commit 5cc3d89

File tree

4 files changed

+75
-24
lines changed

4 files changed

+75
-24
lines changed

CONTRIBUTING.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
# Contributing
2+
3+
## Git Branch Workflow
4+
5+
This project adheres to [GitHub Flow](https://guides.github.com/introduction/flow/).
6+
7+
## Development
8+
9+
### Public Class Constructors
10+
11+
The following options are available as well the as the documented ones in each [Class Constructor ](./docs/README.md) to allow you to use test endpoints for local development or end to end testing
12+
13+
| Parameter | Required | Type | Description |
14+
| --------------------------- | -------- | -------- | ----------------------------------------------------------------------------------------- |
15+
| `options.oneBlinkAPIOrigin` | No | `string` | The Origin of the OneBlink API. Should only be used for development and testing purposes. |
16+
17+
## Publishing Releases
18+
19+
## Beta Process
20+
21+
1. Checkout `master` and get the latest code
22+
23+
```
24+
git checkout master && git pull
25+
```
26+
27+
1. Bump the version and create a release commit
28+
29+
```
30+
npm version x.x.x-beta.x --message "[RELEASE] %s"
31+
```
32+
33+
1. Push changes to the `master` branch
34+
35+
```
36+
git push && git push --tags
37+
```
38+
39+
1. Publish changes to npm
40+
41+
```
42+
npm publish --tag beta
43+
```
44+
45+
## Production Process
46+
47+
1. Checkout `master` and get the latest code
48+
49+
```
50+
git checkout master && git pull
51+
```
52+
53+
1. Run CLI `package-diff-summary {last-tag}`
54+
55+
1. Copy result (if there is one) under a _Dependencies_ heading in [Changelog](./CHANGELOG.md)
56+
57+
1. Update the [Changelog](./CHANGELOG.md) by replacing `Unreleased` with `x.x.x (YYYY-MM-DD)`
58+
59+
1. Bump the version and create a release commit
60+
61+
```
62+
npm version x.x.x --message "[RELEASE] %s"
63+
```
64+
65+
1. Push changes to the `master` branch
66+
67+
```
68+
git push && git push --tags
69+
```
70+
71+
1. Publish changes to npm
72+
73+
```
74+
npm publish
75+
```

README.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,3 @@ npm install @oneblink/sdk --save
1313
- [Usage Documentation](./docs/README.md)
1414
- [Form Submissions](./docs/form-submissions.md)
1515
- [Form Element Definitions](./docs/form-elements/README.md)
16-
17-
## Internal Documentation
18-
19-
- [Development](./docs/development.md)

docs/deployment.md

Lines changed: 0 additions & 11 deletions
This file was deleted.

docs/development.md

Lines changed: 0 additions & 9 deletions
This file was deleted.

0 commit comments

Comments
 (0)