Skip to content

Commit

Permalink
doc: 2.0.4 documents (#83)
Browse files Browse the repository at this point in the history
* feat: 2.0.4 document

* feat: add notice in README.md

* docs: add new issue template

* feat: edit new README.md

* docs: update pr template
  • Loading branch information
kidneyweakx committed Sep 27, 2023
1 parent 7fc749a commit d3ada34
Show file tree
Hide file tree
Showing 13 changed files with 277 additions and 64 deletions.
57 changes: 57 additions & 0 deletions .github/COMMIT_CONVENTION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
### Git Commit Rule

> This is adapted from [Angular's commit convention](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular).
Git commits should adhere to the following rule to automatically generate changelogs:

```
# Follow the Angular commit conventional format
/^(revert: )?(feat|fix|docs|refactor|perf|test|workflow|ci|chore|types)(\(.+\))?: .{1,50}/
```

We utilize three tags to simplify the rules:

- `feat:` for new features
- `fix:` for bug fixes
- `doc:` for documentation changes.

### Git Flow (Branch Rule)

```mermaid
%%{init: { 'logLevel': 'debug', 'theme': 'base', 'gitGraph': {'showBranches': true, 'showCommitLabel':true,'mainBranchName': "main" }} }%%
gitGraph
commit
commit tag: "v1.0.0"
branch "develop(gitlab)"
checkout "develop(gitlab)"
branch version
checkout version
branch feat/featureExample
checkout feat/featureExample
commit
commit
checkout version
merge feat/featureExample
branch fix/fixExample
checkout fix/fixExample
commit
commit
checkout version
merge fix/fixExample
branch docs/docsExample
checkout docs/docsExample
commit
commit
checkout version
merge docs/docsExample
checkout "main"
merge version tag: "v1.0.1"
commit
```

- `feat/<yourBranchName>` :develop new feature
- `fix/<yourBranchName>`:edit old feature
- `docs/<yourBranchName>` :add docs or example
- `<version>` : the version before release ex. 2.0.0
- `develop` :only for gitlab branch, for rebase github master branch. Not exist in github develop flow
- `master` :github main branch, only update by merge request
File renamed without changes.
50 changes: 0 additions & 50 deletions .github/ISSUE_TEMPLATE.md

This file was deleted.

81 changes: 81 additions & 0 deletions .github/ISSUE_TEMPLATE/1.bug-report.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
name: 🐛 Bug Report
description: Report a bug in bdk
labels: ['type:bug', 'priority:high']
assignees: 'kidneyweakx'

body:
- type: markdown
attributes:
value: |
This template is for the unexpected errors or bugs in bdk. If you have a question, please ask in questions section in issues.
- type: dropdown
attributes:
label: 影響範圍 Which area(s) are affected? (Select all that apply)
multiple: true
options:
- 'Not sure'
- 'Fabric'
- 'Fabric-CA'
- 'Fabric-Chaincode'
- 'Fabric-Explorer'
- 'Quorum'
- 'Quorum-Remote'
- 'Quorum-Explorer'
- 'Docker'
- 'Dockerode'
- 'Node.js'
- 'Workflows(CI/CD)'

- type: textarea
attributes:
label: 測試環境 Provide environment information
description: Please list your operating system, Node.js version, npm version,
render: bash
placeholder: |
BDK:
Version: 2.0.4
Operating System:
Platform: macOS
Arch: arm64
Version: Darwin Kernel Version 22.5.0
Binaries:
Node: 16.13.2
npm: 9.5.1
Docker:
client: 24.0.5
compose: 2.20.2-desktop.1
validations:
required: true

- type: textarea
attributes:
label: 重現步驟 To Reproduce
description: A step-by-step description of how to reproduce the issue, based on the linked reproduction. Screenshots can be provided in the issue body below. If using code blocks, make sure that [syntax highlighting is correct](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks#syntax-highlighting) and double check that the rendered preview is not broken.
placeholder: |
1. Start quorum node
2. Start quorum explorer
validations:
required: true

- type: textarea
attributes:
label: 應呈現結果 Expected Behavior
description: Please describe the behavior expected.
placeholder: |
Should open a explorer in browser
- type: textarea
attributes:
label: 實際呈現結果 Resulted Behavior
description: Please describe the behavior that actually occurred.
placeholder: |
explorer not open in browser
- type: checkboxes
attributes:
label: 驗證版本 Verify bdk release
description: 'Please run `bdk --version` besure you are using the latest version.'
options:
- label: I verified that my version is the stable release or 1.0.4
required: true
34 changes: 34 additions & 0 deletions .github/ISSUE_TEMPLATE/2.docs-error.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
name: 📃 Docs Improvement
description: Docs error in bdk
labels: ['type:docs', 'priority:low']

body:
- type: markdown
attributes:
value: |
This template is for the docs/example error in bdk. If you have a question, please ask in questions section in issues.
- type: markdown
attributes:
value: Thank you for helping us improve the docs!

- type: textarea
attributes:
label: What is the improvement or update you wish to see?
description: 'Example: I would like to see more examples of how to use quorum node.'
validations:
required: true

- type: textarea
attributes:
label: Is there more context that might help us understand?
description: A clear description about the suggestion.
validations:
required: true

- type: input
attributes:
label: Does the docs page already exist? Please link to it.
description: 'Example: https://github.com/cathayddt/bdk/wiki/link'
validations:
required: false
29 changes: 29 additions & 0 deletions .github/ISSUE_TEMPLATE/3.feature-request.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
name: 🛠️ Feature Request
description: Request a feature in bdk
labels: ['type:feature', 'priority:medium']

body:
- type: markdown
attributes:
value: |
This template is for feature requests in bdk. If you have a question, please ask in questions section in issues.
- type: textarea
attributes:
label: What is the problem that you are trying to solve?
description: A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
validations:
required: true

- type: textarea
attributes:
label: 新功能 Feature Request
description: Reason for this Feature
validations:
required: true

- type: textarea
attributes:
label: 可能的解法 Proposed Solution
validations:
required: true
16 changes: 16 additions & 0 deletions .github/ISSUE_TEMPLATE/4.question.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
name: ❓ Question
description: Ask a question in bdk
labels: ['type:question', 'priority:low']

body:
- type: markdown
attributes:
value: |
This template is for questions in bdk. Feel free to ask any questions about bdk.
- type: textarea
attributes:
label: What is the question?
description: A clear and concise description of what the question is.
validations:
required: true
1 change: 1 addition & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
blank_issues_enabled: false
20 changes: 14 additions & 6 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,23 @@
# PULL REQUEST

## Before
<!-- Please check the one that applies to this PR using "x". -->
- [ ] 遵守 Commit 規範 (follow [commit convention](https://github.com/cathayddt/bdk/blob/master/.github/COMMIT_CONVENTION.md))
- [ ] 遵守 Contributing 規範 (follow [contributing](https://github.com/cathayddt/bdk/blob/master/.github/CONTRIBUTING.md))

## 說明 (Description)
<!-- If this PR contains a breaking change, please describe the impact and migration path for existing applications below. -->

請簡單說明此PR的更動、被修復的問題以及相關的原因,並請列出這個更動所需要的任何相依模組/套件。
<!--請簡單說明此PR的更動、被修復的問題以及相關的原因,並請列出這個更動所需要的任何相依模組/套件。
Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.
Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. List any dependencies that are required for this change.-->

## 相關問題 (Linked Issues)
- #(issue1)
- #(issue2)
- #(issue3)
<!--
- Related issues linked `fixes #number`
- Tests added. Pass Coverage.
- Errors have a helpful link.
-->

## 貢獻種類 (Type of change)

Expand All @@ -19,7 +27,7 @@ Please include a summary of the change and which issue is fixed. Please also inc
- [ ] Doc change (需要更新文件 this change requires a documentation update)

**測試環境 (Test Configuration)**:
* OS:
* OS:
* NodeJS Version:
* NPM Version:
* Docker Version:
Expand Down
23 changes: 23 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,29 @@
這份文件將記錄 BDK 專案的變更日誌

All notable changes to BDK project will be documented here.
## [2.0.4](https://github.com/cathayddt/bdk/releases/tag/2.0.4) - 2023-09-27

### Features

* Add notice in README.md
* 2.0.4 document
* Add bdk wallet create function [#81](https://github.com/cathayddt/bdk/issues/81)
* Genesis.json model [#80](https://github.com/cathayddt/bdk/issues/80)
* Select and excute command [#77](https://github.com/cathayddt/bdk/issues/77)
* Handle select input and change terminal display [#76](https://github.com/cathayddt/bdk/issues/76)
* Ink ui template with commands [#74](https://github.com/cathayddt/bdk/issues/74)

### Fixes

* Upgrade action [#84](https://github.com/cathayddt/bdk/issues/84)
* Explorer indexer error [#82](https://github.com/cathayddt/bdk/issues/82)
* Add export type in index.ts [#52](https://github.com/cathayddt/bdk/issues/52)
* Approve and update don't use arrow function [#45](https://github.com/cathayddt/bdk/issues/45)

### Documentation

* Add new issue template

## [2.0.3](https://github.com/cathayddt/bdk/releases/tag/2.0.3) - 2023-06-27

### Features
Expand Down
22 changes: 18 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,17 @@
# Blockchain Deployment Kit
<div align="center">
<h1>Blockchain Development Kit</h1>
<pre>
:::::::: ::::::: ::: :::
:+: :+: :+: :+: :+: :+:
+:+ +:+ +:+ +:+ +:+ +:+
+#++:++#+ +#+ +:+ +#++:++
+#+ +#+ +#+ +#+ +#+ +#+
#+# #+# #+# #+# #+# #+#
######## ######## ### ###
</pre>

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](./LICENSE) [![codeql-analysis](https://github.com/cathayddt/bdk/actions/workflows/codeql.yml/badge.svg)](https://github.com/cathayddt/bdk/actions/workflows/codeql.yml) [![test-report](https://github.com/cathayddt/bdk/actions/workflows/test-report.yml/badge.svg)](https://github.com/cathayddt/bdk/actions/workflows/test-report.yml) [![unit-test](https://github.com/cathayddt/bdk/actions/workflows/unit-test.yml/badge.svg)](https://github.com/cathayddt/bdk/actions/workflows/unit-test.yml)
</div>

提供指令快速建立、管理、監控 blockchain,最大的特色是可以使用互動式的問答,讓使用者可以依續性的問答來完成指令所需要的指令,在每個 BDK 指令的後面,加入 `-i` 或是 `--interactive` 的參數,來使用互動式問答

Expand All @@ -21,9 +34,9 @@ bdk fabric network create -i

| Latest | Stable |
| ---------------- | ---------------- |
| [v2.0.3][v2.0.3] | [v2.0.3][v2.0.3] |
| [v2.0.4][v2.0.4] | [v2.0.4][v2.0.4] |

[v2.0.3]: https://github.com/cathayddt/bdk/releases/tag/v2.0.3
[v2.0.4]: https://github.com/cathayddt/bdk/releases/tag/v2.0.4

[更新內容 (Changelog)](CHANGELOG.md)

Expand All @@ -32,7 +45,7 @@ bdk fabric network create -i
- 指令文件 CLI Documentation (Work in Progress)
- [Fabric 使用範例 (Examples)](docs/fabric/EXAMPLE.md)
- [Quorum 使用範例 (Examples)](docs/quorum/EXAMPLE.md)
- [開發指南 (Contributing)](CONTRIBUTING.md)
- [開發指南 (Contributing)](.github/CONTRIBUTING.md)
- [資安通報 (Security Issues)](SECURITY.md)

## 安裝流程 (Getting Started)
Expand All @@ -42,6 +55,7 @@ bdk fabric network create -i
- [npm + nodejs](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) node v16, npm v8
- [docker](https://docs.docker.com/engine/install)
- [docker-compose](https://docs.docker.com/compose/install) >= 1.27
- [docker-desktop(MacOS)](https://www.docker.com/products/docker-desktop/) Need Allow Docker Sockers in Advanced Options
- eslint (vscode plugin, dev-only)

### 主程式安裝 (Installation)
Expand Down
Loading

0 comments on commit d3ada34

Please sign in to comment.