blob: ef97b75e2b79e9974ee630d2ab232be5fc077ed7 [file] [log] [blame]
Joey Armstrong3980d702023-08-23 10:57:18 -04001Jira tickets for code changes
2=============================
3
4Please open a `jira ticket <https://jira.opencord.org/projects/VOL>`_ describing the issue/feature.
5
6- For large or multi-part features create a containing ticket with several
7 sub-tickets tracking individual features or problems.
Joey Armstrong704dd6d2023-08-24 08:01:47 -04008
9 - Primary tracking ticket.
10 - VOL-5125 - Tracking ticket for bbsim failures in jenkins vip job view.
11
12 - Sub-ticket(s)
13 - VOL-5024 - bbsim unit test job reporting status=UNSTABLE
14 - VOL-5157 - verify_bbsim_unit-test failures in history
15 - VOL-5154 - Triage test failure in periodic-voltha-unitag-subscriber-tt-test-bbsim
16
17- Description - include relevant information
Joey Armstrong3980d702023-08-23 10:57:18 -040018
19 - Error messages
20 - Reproduction step(s) for problems
21 - Web URLs, links to jenkins job logs are very helpful.
22
23 - Note: Jenkins job logs will age out and disappear over time.
24 - To prevent this view the job history panel in jenkins UI
25
Joey Armstrong704dd6d2023-08-24 08:01:47 -040026 - `View a jenkins job page <https://jenkins.opencord.org/view/vip/job/verify_bbsim_unit-test>`_
27 - Two links are available in history (lower left corner), colored icon on the left and #job on the right.
Joey Armstrong3980d702023-08-23 10:57:18 -040028 - Click the #job link to view job.
29 - Top right corner will contain a clickable button "Keep this build forever".
Joey Armstrong704dd6d2023-08-24 08:01:47 -040030 - At some point in the future after a ticket has been resolved
31 remember to revisit the job log and unfreeze it (click button:
32 Do not keep this build forever)
Joey Armstrong3980d702023-08-23 10:57:18 -040033
34- Assign field ``Fix Version/s:`` VOLTHA-X.Y
35
36 - This will enables searching for feature by release.
37 - Leveraged during release to document fixes and enhancements in release notes.
38- While viewing a jira ticket, the 'More' navigation pulldown menu at the top
39 is useful for creating sub tickets or creating links to external resources.
40
41See Also
42--------
43
44- https://jira.opencord.org
45- `jira :: VOLTHA <https://jira.opencord.org/projects/VOL/issues/VOL-4470?filter=allopenissuse>`_