bug 1244: add linked list ddffirst image
[libreriscv.git] / HDL_workflow / libresoc_bug_process.mdwn
index 218b36edc08e28d9e93f7ca2acd39f424297a430..1d74e36dc74691a49f181ebec5e058444ad7b283 100644 (file)
@@ -7,6 +7,7 @@
 * [Bug #1126](https://bugs.libre-soc.org/show_bug.cgi?id=1126)
 
 * HDL workflow guide page: [[HDL_workflow]]
 * [Bug #1126](https://bugs.libre-soc.org/show_bug.cgi?id=1126)
 
 * HDL workflow guide page: [[HDL_workflow]]
+* RfP submission process: [[HDL_workflow/rfp_submission_guide]]
 
 This page describes in detail how to raise new tasks (bugs) and how to approach
 development within the project in order to get appropriate amount of funding
 
 This page describes in detail how to raise new tasks (bugs) and how to approach
 development within the project in order to get appropriate amount of funding
@@ -59,6 +60,8 @@ and in the "Search by People" section, check "Bug Assignee" and "contains"
 
 ## Additional info
 
 
 ## Additional info
 
+### Linking bugs - 'use bug#NNN' format
+
 - When mentioning other bugs in bug description or comment, use the
 "bug #NNN" format, and not "#NNN". For example, writing `bug #1000` in
 in the bugtracker comment section will create a link to
 - When mentioning other bugs in bug description or comment, use the
 "bug #NNN" format, and not "#NNN". For example, writing `bug #1000` in
 in the bugtracker comment section will create a link to
@@ -67,6 +70,17 @@ Following this syntax ensures the Bugzilla system converts
 every bug reference into a hyperlink which makes things easier to track
 (as you see the interdependencies between various tasks/bugs/milestones etc.).
 
 every bug reference into a hyperlink which makes things easier to track
 (as you see the interdependencies between various tasks/bugs/milestones etc.).
 
+### Do not attempt to re-use bugs
+
+- As LibreSOC uses the bugtracker system for task management and grant/budget
+allocation, it is critical not to change the purpose of a previously created
+bug. If a duplicate bug has been created, mark as `DUPLICATE` (see the
+procedure section further down on this page on additional types of bugs
+which would not be worked on).
+- All comments cannot be removed (with the exception of having no comments
+other than the initial description, *and* no link/references to other bugs).
+- The bug may also be referenced externally, and thus re-use is not permitted.
+
 # Adding sub-tasks to tasks under existing milestone
 
 * notify Michiel and the relevant NNNN-NN@nlnet.nl team of
 # Adding sub-tasks to tasks under existing milestone
 
 * notify Michiel and the relevant NNNN-NN@nlnet.nl team of
@@ -255,6 +269,9 @@ an issue at all, it is to be set to either of the following:
 grant sub-task/s, and budget considered, *then* work can proceed in a separate
 branch. Only after fixes have been confirmed to keep the CI tests passing,
 can they be rebased (to keep commit history) into the master branch.
 grant sub-task/s, and budget considered, *then* work can proceed in a separate
 branch. Only after fixes have been confirmed to keep the CI tests passing,
 can they be rebased (to keep commit history) into the master branch.
+  - *Note*: branch names **should not include personal info** such as names.
+    This is because others may require to use or work on the branch, and no
+    single developer owns a branch.
 
 This procedure adds a time delay between the issue discovery and
 start of work. This is important however because it allows for team members
 
 This procedure adds a time delay between the issue discovery and
 start of work. This is important however because it allows for team members