.jpg%3Falt%3Dmedia%26token%3D5f201171-71dd-4b5f-aaab-d0cc9ee52b5d){kind=logo}
.jpg%3Falt%3Dmedia%26token%3D5f201171-71dd-4b5f-aaab-d0cc9ee52b5d){kind=logo}
<OPEN>: Register a JIRA issue
When you start a new project or if you find a bug, you can start your contribution by creating a JIRA issue. The issues creation process and field values that you need to specify according to the issue types are described in the ‘Issue Creation Procedure’ section below.
You can revert from any statuses of the issue to the status 'OPEN' as needed. In any status during the ongoing status (CONFIRMED, IN PROGRESS, REVIEW IN PROGRESS, REVIEWED), if you need to recheck the issue, press the 'Ask Confirmation/Reconfiguration' button to return the issue to 'OPEN' and specify the project maintainer as assignee.
In addition, if a problem occurs in the closed (‘CLOSED’ status) issue later, you can change the status of the issue back to 'OPEN' by clicking the 'Reopen Bug' button. Resolved (‘RESOLVED’ status) issues are changed to 'OPEN' and delivered to the project maintainer only when there is no developer in charge.
When creating an issue, it is recommended not to deal with multiple issues as one single issue, but to divide the issues into several issues as much as possible.
1. After logging in to CUBRID Jira website (jira.cubrid.org), click the orange 'CREATE' button at the top.
2. In the newly opened 'CREATE Issue' window, fill in each section as described in the following table and click the 'Create' button at the bottom.
Field | Description |
Project | Select a project category. · CBRD: CUBRID CAS, DB SERVER · APIS: Driver such as CCI, JDBC · CUBRIDMAN: CUBRID manual · TOOLS: CUBRID Manager, CUBRID Migration Tool · CUBRIDQA: QA system, QA test case |
Issue Type | Select the type of issue. For more information, refer to the 'Issue Type' section below. |
Summary | Enter the title of the issue. |
Priority | The default setting is ‘Minor’. However, at the time of triage, the project maintainer can change the level of priority if necessary. |
Components | Specifies the category of module units or project units. Details are described in the 'Component' section below. |
Description | Fill in by referring to the ‘issue content template’ section below. |
Affects version/s | Fill in the version in which the issue creator found bugs. |
Label | Type any registered label. * Label managed by project maintainer: cubrid.com, Good First Issue |
Type name | Description |
Correct Error | Issue that fixes bugs or errors. |
Improve Function/Performance | Issue that improves existing features or performance. |
Development Subject | Issue that adds new features. |
Internal Management | Issue for internal management. Use when changes are not related to contributions. e.g. changing the version name within a program or code from 10.2.0 to 11.0.0.0 |
Refactoring | Issue that changes unnecessary code clean-up, code structure, and repository separation. |
Task | The issue type is applied if there is no category corresponding to the above issue type but is not recommended. (Example of use: release) |
Sub-task | This issue type is applied when an issue is a small unit created inside the issue. |
CBRD
APIS
TOOLS
Category Component |
QP
SM
DS
Utility |
Module Component |
Build CI Coding Style Community Document |
Broker/CAS Server Communication CSQL |
Query Parser
Query Semantic Check
Query Rewriter Query Optimizer
XASL Generator Query Executor Scan Manager Schema Manager Java SP |
Backup/Restore Buffer pool
Catalog
Disk/File
DWB
FBO Heap
Index
Locator Lock
Log/Recovery MVCC
TDE
Transaction Vacuum |
Failover
HA
Heartbeat
Logcopier
Logapplier Replication |
Module Component |
ADO.NET
CCI
GO
JDBC
Node.js
ODBC
OLEDB
PDO
Perl
PHP
Python
Ruby |
Module Component |
CM Server
CUBRID Manager
CUBRID Migration Toolkit
CUBRID Monitoring
Query Browser
Tools development |
The component is set in module unit. Components are organized in a hierarchical structure and are increasingly subdivided. You can select multiple components in an issue. The above table are the components available for each project-specific CUBRID project. As shown in the table, CUBRID includes SM, QP, JavaSP, DS, Utility, etc., and each module also includes multiple modules.
When creating an issue, select the relevant module that is known at that time. In the process of investigating an issue, you can additionally select module information related to the issue. For example, in the case of an issue that improves the Buffer Manager in the SM module, you can select CUBRID, SM, or Buffer when creating an issue, and if it affects the File and Lock module while the issue is in progress, you can additionally select the Disk/File AND Lock module.
For projects that affect multiple modules, such as CTE, TDE, JSON, and Java SP, you can create and configure a new component. If necessary, you can ask the project maintainer to create a new component.
When creating an issue, copy the following template according to the issue type and write the necessary items:
> You can add sections if needed.
> If you do not need a section in the template, do not remove it and fill in with 'N/A'.
> If the fields can not be filled out, write down 'TBD' and fill in the content when it is confirmed.
In the following template, three types of issue are displayed.
Description Test Build Repro Expected Result
Actual Result
Additional Information |
- Description: Issue Description
- Test Build: Detail the build version that shows the same format as Repro, Actual Result to commit number. For example, you can write:
CUBRID-11.0.0.0248-b53ae4aAffected version/s in the JIRA field displays only the Major and Minor versions, while you must enter the specific version name where the bug actually occurred, including Patch and Revision. For version name rules, refer to the Release/Version section. You can also specify the version of the OS you built. - Repro: Enter the procedure to reproduce the bug. Rather than writing a description of bug reproduction, all procedures such as environment reproduction, schema creation, query execution, and utility execution should be written so that they can be reproduced by copy-paste.
- Expected Result: Expected results (expected results to be fixed)
- Actual Result: Current results (problematic results)
- Additional Information: If there is any additional material or content that can be helpful to understand the bug, please write it down.
Description
Specification Changes
Implementation
Acceptance Criteria Definition of done |
- Description: Issue Description
- Specification Changes: Organize and write the specifications to be changed. It can be used for defining QA tests, writing manuals, etc.
- Implementation: Create design specifications, implementation concepts and details to address issues.
- Acceptance Criteria: Define behaviors/results that must be satisfied within the scope of the issue you have chosen while conducting design and implementation according to your requirements. This content is the basis for the completion to review the design/implementation. If undefined behavior/results are critical, design/implementation needs to be reviewed.
- Definition of done: Write down the criteria of the completion of the issue. You can write as the following example:
- Satisfies the Acceptance Criteria.
- Pass the QA test.
Description |
- Description: Write down the purpose and description of the work.