aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorcyuamber <xuranyjy@chinamobile.com>2021-03-04 11:07:04 +0800
committercyuamber <xuranyjy@chinamobile.com>2021-03-04 11:07:10 +0800
commitab00dc61c4f1206fbd906251b4c01ede0b89e990 (patch)
tree6885e9503b6f08984735738a106b892f5d76850d
parent2c986f407f298f765a5cbb4908ece99851bbba2e (diff)
docs: add README doc
Change-Id: I86906da0fd549f94c0ab9dc2f046a06569289234 Issue-ID: USECASEUI-530 Signed-off-by: cyuamber <xuranyjy@chinamobile.com>
-rw-r--r--README.md74
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.
+```