Permalink
Switch branches/tags
usecase-bus@1.1.0 node-memory-leak-testing@2.0.1 node-memory-leak-testing@2.0.0 example-todomvc@1.1.0 example-todomvc@1.0.2 example-todomvc@1.0.1 example-todomvc-typescript@1.1.0 example-todomvc-flow@1.1.0 example-todomvc-flow@1.0.2 example-todomvc-flow@1.0.1 example-svg-feeling@1.1.0 example-svg-feeling@1.0.2 example-svg-feeling@1.0.1 example-shopping-cart@1.1.0 example-shopping-cart@1.0.2 example-shopping-cart@1.0.1 example-perf-node-memory-leak-testing@2.1.0 example-perf-benchmark@1.1.0 example-introduction@1.1.0 example-counter@1.1.0 example-counter@1.0.2 example-counter@1.0.1 benchmark@1.0.2 benchmark@1.0.1 almin@0.18.1 almin@0.18.0 almin@0.17.1 almin@0.17.0 almin@0.16.0 almin@0.15.3 almin@0.15.2 almin@0.15.1 almin@0.15.0 almin@0.14.0 almin@0.13.11 almin@0.13.10 almin@0.13.9 almin@0.13.8 almin@0.13.7 almin@0.13.6 almin@0.13.5 almin@0.13.4 almin@0.13.3 almin@0.13.2 almin@0.13.1 almin@0.13.0 almin@0.12.5 almin@0.12.4 almin@0.12.3 almin@0.12.2 almin@0.12.1 almin@0.12.0 @almin/usecase-bus@1.2.2 @almin/usecase-bus@1.2.1 @almin/usecase-bus@1.2.0 @almin/store-test-helper@1.1.3 @almin/store-test-helper@1.1.2 @almin/store-test-helper@1.1.1 @almin/store-test-helper@1.1.0 @almin/react-context@1.1.3 @almin/react-context@1.1.2 @almin/react-context@1.1.1 @almin/react-context@1.1.0 almin-react-container@0.7.3 almin-react-container@0.7.2 almin-react-container@0.7.1 almin-react-container@0.7.0 almin-react-container@0.6.4 almin-react-container@0.6.3 almin-react-container@0.6.2 almin-react-container@0.6.1 almin-react-container@0.6.0 almin-react-container@0.5.0 almin-react-container@0.4.0 almin-react-container@0.3.11 almin-react-container@0.3.10 almin-react-container@0.3.9 almin-react-container@0.3.8 almin-react-container@0.3.7 almin-react-container@0.3.6 almin-react-container@0.3.5 almin-react-container@0.3.4 almin-react-container@0.3.3 almin-react-container@0.3.2 almin-react-container@0.3.1 almin-react-container@0.3.0 almin-react-container@0.2.2 almin-react-container@0.2.1 almin-react-container@0.2.0 almin-logger@6.2.3 almin-logger@6.2.2 almin-logger@6.2.1 almin-logger@6.2.0 almin-logger@6.1.5 almin-logger@6.1.4 almin-logger@6.1.3 almin-logger@6.1.2 almin-logger@6.1.1 almin-logger@6.1.0 almin-logger@6.0.0
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
158 lines (103 sloc) 3.59 KB

Contributing Guide

Almin uses Yarn for running development scripts. If you haven't already done so, please install yarn.

Environment

  • Node.js >= 6.0.0
  • Yarn

Bootstrap

First, you should install all dependencies by following:

# In project root
yarn install

Almin repository is monorepo top on lerna. postinstall life-cycle script automatically run yarn run bootstrap that install all deps/devDeps.

How to contribute?

You can find suitable issues to contribute on Issues label:good first issue.

Of course, welcome to fix the other issue or file issue.

Basic Pull Request steps:

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D

How to run tests?

Run all tests that includes examples in Node.js:

yarn test
# It includes unit test/example test

You can only run unit test:

cd packages/almin && yarn test
# or
yarn test -- --scope almin

Run unit tests in Browser:

cd packages/almin && yarn run test:browser

How to fix document?

Contribute to fix documents

  1. Fix the issue
  2. Preview documents
cd website
yarn install
yarn start

Welcome to fix documents!

Contribute to fix API Reference

API Reference is automatically generated from source code(`/src/*.ts``)

  1. Fix the comment of source code
  2. Build API Reference
yarn run build:docs:api # build

How to write document?

  1. Add Markdown document to docs/ directory.
  2. Add link to SUMMARY.md

How to write git commit message?

Almin has adopted Conventional Commits

Conventional Commits

                       component        commit title
        commit type       /                /      
                \        |                |
                 feat(rule-context): add template url parameter to events

        body ->  The 'src` (i.e. the url of the template to load) is now provided to the
                 `$includeContentRequested`, `$includeContentLoaded` and `$includeContentError`
                 events.

 referenced  ->  Closes #8453
 issues          Closes #8454
  • commit type:
    • BREAKING CHANGE: breaking change(major update)
    • feat: add new feature(minor update)
    • fix: fix a bug(patch update)
    • style: format style(patch update)
    • refactor: refactoring(patch update)
    • perf: it is related performance(patch update)
    • test: update tests(patch update)
    • docs: update documents(patch update)
    • chore: the other(patch update)
  • component: package name or file name
    • e.g.) almin, almin-logger

If you commit cross component changes in a pull request, separate commits by component.

Example: commit message

Example: Add new feature – This is minor update

feat(almin): add new feature

Describe in details.

fix #42

Example: Fix a bug

fix(almin): `tryUpdateState` should be called before finished 

Describe in details.

fix #42

Example: BREAKING CHANGE

feat(almin): Change default StoreGroup

BREAKING CHANGE: make `StoreGroup` as default store

fix #42

How to release?

Run following commands:

yarn test
yarn run publish