Skip to content
Snippets Groups Projects

Add common nomenclature for new issue

Closed Luca Favaretto requested to merge lucafavaretto/oniro:nomenclature into kirkstone
4 unresolved threads
1 file
+ 59
0
Compare changes
  • Side-by-side
  • Inline
+ 59
0
@@ -7,7+7,7 @@
- [Gitlab Contributions](#gitlab-contributions)
- [Overview](#overview)
- [Commit Guidelines](#commit-guidelines)
- [Contributions to Documentation](#contributions-to-documentation)
Please register or sign in to reply
- [REUSE Compliance](#reuse-compliance)
- [SPDX Information and REUSE Standard](#spdx-information-and-reuse-standard)
- [SPDX Header Example](#spdx-header-example)
@@ -97,7+97,7 @@
As a rule of thumb, anything that ends up compiled in the project documentation is to maintain the RestructuredText file format. Text files that are not meant to be compiled as part of the project's documentation can be written in [Markdown](https://daringfireball.net/projects/markdown/). For example, a repository `README` file can be written in Markdown as it doesn't end up compiled in the project-wide documentation.
## Nomenclature for new issue
Please register or sign in to reply
In Oniro Project, for the opening of a new `Issue::Bug` the team decided to adopt a common nomenclature to apply to the title of the new Issue. Depending on the scope to which the issue refers, three options are defined.
### Option 1 - Board-related
When the issue is opened related to a specific board, the parameters to be given are: Domain and Board.
[MAINTENANCE][$BOARD] - $Title
[NETWORK][$BOARD] - $Title
[OpenHarmony][$BOARD] - $Title
[OTA][$BOARD] - $Title
[SECURITY][$BOARD] - $Title
[PERFORMANCE][$BOARD] - $Title
[HW][$BOARD] - $Title
[TOOLCHAIN][$BOARD] - $Title
[MISCELLANEOUS][$BOARD] - $Title
Example:
[Maintenance][SECO C61] - Build failed due to ModemManager error
### Option 2 - Blueprint related
When the issue is opened related to a specific blueprint, the parameters to be given are: Blueprint and Domain; if necessary even Board (when Blueprint has more than one board in the configuration. To be omitted if there is only one board).
[$BP - MAINTENANCE][$BOARD] - $Title
[$BP - NETWORK][$BOARD] - $Title
[$BP - OpenHarmony][$BOARD] - $Title
[$BP - OTA][$BOARD] - $Title
[$BP - SECURITY][$BOARD] - $Title
[$BP - PERFORMANCE][$BOARD] - $Title
[$BP - HW][$BOARD] - $Title
[$BP - TOOLCHAIN][$BOARD] - $Title
[$BP - MISCELLANEOUS][$BOARD] - $Title
Examples:
[CATS - HW] - Black screen when flashing the image
[ENERGY GATEWAY - OTA][Raspberry Pi 4B] - Can't upload the image via OTA
### Option 3 - Domain related
When the issue isn't opened related to a specific blueprint or board, the parameters to be given is Domain.
[MAINTENANCE] - $Title
[NETWORK] - $Title
[OpenHarmony] - $Title
[OTA] - $Title
[SECURITY] - $Title
[PERFORMANCE] - $Title
[HW] - $Title
[TOOLCHAIN] - $Title
[MISCELLANEOUS] - $Title
Please register or sign in to reply
Examples:
[SECURITY] - Security configuration error on Linux Kernel
# REUSE Compliance
## SPDX Information and REUSE Standard
Loading