chore: Add semantic release, update docs, add contribution guide

Author: krizzu

.circleci/config.yml

@@ -278,6 +278,18 @@ jobs:
           name: Run e2e tests
           command: yarn test:e2e:android
 
+  "Publish: semantic release":
+    <<: *js_defaults
+    steps:
+      - restore-cache: *cache_restore_yarn
+      - run:
+          name: Install dependencies
+          command: yarn --pure-lockfile --non-interactive --cache-folder ~/.cache/yarn
+      - save-cache: *cache_save_yarn
+      - run:
+        name: Publish to NPM registry
+        command: yarn ci:publish 
+
 # ==============================
 # WORK FLOWS
 # ==============================
@@ -304,4 +316,11 @@ workflows:
           requires:
             - "Test: lint"
             - "Test: flow"
-            - "Build: Android release apk"
+            - "Build: Android release apk"
+      - "Publish: semantic release":
+          requires:
+            - "Test: Android e2e"
+            - "Test: iOS e2e"
+          filters:
+            branches:
+              only: master

.github/ISSUE_TEMPLATE/01_bug_report.md

@@ -0,0 +1,24 @@
+---
+name: ':bug: Bug report'
+about: Something not working as expected
+label: 'Bug'
+---
+
+## Current behavior
+
+<!-- Describe the issue. -->
+
+## Expected behavior
+
+<!-- Describe what the desired behavior would be. -->
+
+## Repro steps
+
+<!-- Please provide us steps (in points) how we can reproduce the issue. -->
+
+## Environment
+
+- **Async Storage version**: <!-- @react-native-community/async-storage version set in package.json -->
+- **React-Native version**: <!-- React Native version set in package.json -->
+- **Platform tested**: <!--  iOS / Android -->
+- **Logs/Error that are relevant**: <!-- link to your CI logs or semantic-release logs -->

.github/ISSUE_TEMPLATE/02_feature_request.md

@@ -0,0 +1,17 @@
+---
+name: ':wrench: Feature request'
+about: New functionality for Async Storage
+label: 'Enhancement'
+---
+
+## Motivation
+
+<!-- Describe the context, the use-case and the advantages of the feature request. -->
+
+## Description
+
+<!-- Describe the functional changes that would have to be made -->
+
+## New feature implementation
+
+<!-- Optionally, describe the technical changes to be made -->

.github/ISSUE_TEMPLATE/03_question_discussion.md

@@ -0,0 +1,11 @@
+---
+name: ':speaking_head: Have a question / start a discussion'
+about: You want to ask or discuss something
+label: 'Question/Discussion'
+---
+
+## You want to:  
+<!-- Ask question / Discuss something -->
+
+## Details:
+<!-- Place for your question/discussion -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,11 @@
+Summary:
+---------
+
+<!-- Thank you for sending the PR!
+Help us understand more of your work - you can explain what you did, post a link to an issue etc. Anything helps! -->
+
+
+Test Plan:
+----------
+
+<!-- Help us test your work (**REQUIRED**). If you changed code, please provide us with instruction of how we can try it out ourselves, so we can confirm it's working. You can also post screenshots/gifts.  -->

.releaserc

@@ -0,0 +1,15 @@
+{
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/npm",
+    "@semantic-release/github",
+    [
+      "@semantic-release/git",
+      {
+        "assets": "package.json",
+        "message": "chore(release): ${nextRelease.version} [skip ci] \n\n${nextRelease.notes}"
+      }
+    ]
+  ]
+}

CONTRIBUTING.md

@@ -0,0 +1,51 @@
+# Contributing to React Native Async Storage
+
+Thank you for helping out with Async Storage!
+We'd like to make contributions as pleasent as possible, so here's a small guide of how we see it. Happy to hear your feedback about anything, so please let us know.
+
+
+## Tests
+We use `flow` for type check, `eslint` with `prettier` for linting/formatting, `jest/detox` for tests (unit and e2e). All tests are run on CircleCI for all opened pull requests, but you should use them locally when making changes.
+
+* `yarn test`: Run all tests, except for e2e (see note below).
+* `yarn test:lint`: Run `eslint` check.
+* `yarn test:flow`: Run `flow` type check.
+* `yarn test:e2e:<ios|android>`: Runs e2e tests. Before you can run it, you should build the app that can be run, by using `yarn build:e2e:<ios|android>`.
+
+
+## Sending a pull request
+When you're sending a pull request:
+
+* Communication is a key. If you want fix/add something, please open new/find existing issue, so we can discuss it.
+* We prefer small pull requests focused on one change, as those are easier to test/check.
+* Please make sure that all tests are passing on your local machine.
+* Follow the template when opening a PR.
+
+
+## Commits and versioning
+All PRs are squashed into `master` and wrapped up in a single commit, following [conventional commit message](https://www.conventionalcommits.org/en/v1.0.0-beta.3). Combined with [semantic versioning](https://semver.org/), this allows us to have a frequent releases of the library.
+
+*Note*: We don't force this convention on Pull Requests from contributors, but it's a clean way to see what type of changes are made, so feel free to follow it. 
+
+
+Most notably prefixes you'll see:
+
+* **fix**: Bug fixes, triggers *patch* release
+* **feat**: New feature implemented, triggers *minor* 
+* **chore**: Changes that are not affecting end user (CI config changes, scripts, ["grunt work"](https://stackoverflow.com/a/26944812/3510245))
+* **docs**: Documentation changes.
+* **perf**: A code change that improves performance.
+* **refactor**: A code change that neither fixes a bug nor adds a feature.
+* **test**: Adding missing tests or correcting existing tests.
+
+
+## Release process
+We use [Semantic Release](http://semantic-release.org) to automatically release new versions of the library when changes are merged into master. Using the commit message convention described above, it will detect if we need to release a patch, minor, or major version of the library.
+
+
+## Reporting issues
+You can report issues on our [bug tracker](https://github.com/react-native-community/react-native-async-storage/issues). Please search for existing issues and follow the issue template when opening an one.
+
+
+## License
+By contributing to React Native Async Storage, you agree that your contributions will be licensed under the **MIT** license.

README.md

@@ -75,6 +75,10 @@ const {
 
 See docs for [api and more examples.](docs/API.md)
 
+## Contribution
+
+See the [CONTRIBUTING](CONTRIBUTING.md) file for how to help out.
+
 ## License
 
 MIT

package.json

@@ -28,14 +28,16 @@
     "test:flow": "flow check",
     "test:lint": "eslint 'lib/**/*.js' 'example/**/*.js'",
     "test:e2e:ios": "detox test -c ios",
-    "test:e2e:android": "detox test -c android"
+    "test:e2e:android": "detox test -c android",
+    "ci:publish": "yarn semantic-release"
   },
   "peerDependencies": {
     "react": "^16.0",
     "react-native": "^0.57.0"
   },
   "devDependencies": {
     "@babel/core": "7.0.0",
+    "@semantic-release/git": "7.0.8",
     "babel-core": "7.0.0-bridge.0",
     "babel-eslint": "9.0.0",
     "babel-jest": "24.1.0",
@@ -57,7 +59,8 @@
     "prettier": "1.16.4",
     "react": "16.6.3",
     "react-native": "0.58.4",
-    "react-test-renderer": "16.6.3"
+    "react-test-renderer": "16.6.3",
+    "semantic-release": "15.13.3"
   },
   "jest": {
     "preset": "react-native"