diff options
author | cyuamber <xuranyjy@chinamobile.com> | 2019-08-19 18:36:53 +0800 |
---|---|---|
committer | cyuamber <xuranyjy@chinamobile.com> | 2019-08-19 18:37:01 +0800 |
commit | 15235e6fc3bf84bc14d56e6604e2a76cfcc07db8 (patch) | |
tree | b72735195d7de4931b76211f3818893cf98e3784 | |
parent | fbd2d6628f9d639895ef45b4a100ed00cecfd342 (diff) |
docs: add README.md and CHANGELOG.md
Change-Id: Ifa1c1059ab85e72e62c41529a337d7efc0ce042e
Issue-ID: USECASEUI-306
Signed-off-by: cyuamber <xuranyjy@chinamobile.com>
-rw-r--r-- | README.md | 78 | ||||
-rw-r--r-- | usecaseui-portal/CHANGELOG.md | 8 | ||||
-rw-r--r-- | usecaseui-portal/package.json | 7 |
3 files changed, 87 insertions, 6 deletions
@@ -1,10 +1,82 @@ +# Usecase UI + +This is the frontend part of Usecase UI project. + + +### Getting Started + +1. Go to project folder and install dependencies: + +```bash +npm install +``` + +2. Launch development server, and open `localhost:4200` in your browser: + +```bash +npm start +``` + +### Project Structure + +### [Change log](./CHANGELOG.md) + +### 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 2017 CMCC Corporation. 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 +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, diff --git a/usecaseui-portal/CHANGELOG.md b/usecaseui-portal/CHANGELOG.md new file mode 100644 index 00000000..22702106 --- /dev/null +++ b/usecaseui-portal/CHANGELOG.md @@ -0,0 +1,8 @@ +# [1.0.0](https://gerrit.onap.org/r/usecase-ui/compare/2.0.1...1.0.0) (2019-08-19) + + +### Features + +* add loading for page ([45fe372](https://gerrit.onap.org/r/usecase-ui/commits/45fe372)) +* Home page style optimization ([19a945d](https://gerrit.onap.org/r/usecase-ui/commits/19a945d)) + diff --git a/usecaseui-portal/package.json b/usecaseui-portal/package.json index 701477d6..70035a3c 100644 --- a/usecaseui-portal/package.json +++ b/usecaseui-portal/package.json @@ -1,6 +1,6 @@ { "name": "usecase-ui", - "version": "0.0.0", + "version": "1.0.0", "license": "Apache-2.0", "scripts": { "ng": "ng", @@ -8,7 +8,8 @@ "build": "ng build --prod --aot", "test": "ng test", "lint": "ng lint", - "e2e": "ng e2e" + "e2e": "ng e2e", + "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s" }, "private": true, "dependencies": { @@ -52,4 +53,4 @@ "tslint": "~5.9.1", "typescript": "~2.5.3" } -} +}
\ No newline at end of file |