diff options
author | cyuamber <xuranyjy@chinamobile.com> | 2021-03-04 11:07:04 +0800 |
---|---|---|
committer | cyuamber <xuranyjy@chinamobile.com> | 2021-03-04 11:07:10 +0800 |
commit | ab00dc61c4f1206fbd906251b4c01ede0b89e990 (patch) | |
tree | 6885e9503b6f08984735738a106b892f5d76850d | |
parent | 2c986f407f298f765a5cbb4908ece99851bbba2e (diff) |
docs: add README doc
Change-Id: I86906da0fd549f94c0ab9dc2f046a06569289234
Issue-ID: USECASEUI-530
Signed-off-by: cyuamber <xuranyjy@chinamobile.com>
-rw-r--r-- | README.md | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..40c498b --- /dev/null +++ b/README.md @@ -0,0 +1,74 @@ +# Usecase UI NLP + +This is the NLP processing part of Usecase UI project. + + +### Project Structure + + +### Git commit message rules + +PLEASE obey [AngularJS Git Commit Message Conventions](https://docs.google.com/document/d/1QrDFcIiPjSLDn3EL15IJygNPiHORgU1_OOAqWjiDU5Y/edit#) when write the commit messages. One commit message should include three parts: `Header`, `Body` and `Footer`. The `Header` part is necessary, and the other two parts are optional. The `Header` part follows the rule as: `<type>(<scope>): <subject>`. `type` and `subject` are necessary, `scope` is optional. Only 7 tokens are allowed for `type`: + * feat: new features(feature) + * fix: fix bugs + * docs: documentation + * style: style + * refactor:reconstruction + * test:add test + * chore:change for construction and assistant tools + +For example: + +```bash +feat(directive): ng:disabled, ng:checked, ng:multiple, ng:readonly, ng:selected +----------------------------------------------------- +docs(guide): updated fixed docs from Google Docs + +Couple of typos fixed: +- indentation +- batchLogbatchLog -> batchLog +- start periodic checking +- missing brace +``` + + +When there is breaking changes in the project, please write the commit message in `Footer`. For example: + +```bash + BREAKING CHANGE: isolate scope bindings definition has changed. + + To migrate the code follow the example below: + + Before: + + scope: { + myAttr: 'attribute', + } + + After: + + scope: { + myAttr: '@', + } + + The removed `inject` wasn't generaly useful for directives so there should be no code using it. +``` +Also, run the script `npm run changelog` can generate all the `feat` and `fix` commits. Click [CHANGELOG.md](./CHANGELOG.md) shows all these commit histories. + + + +### Contributor + +``` +Copyright 2021 China Telecom. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +``` |