Differences

This shows you the differences between two versions of the page.

--- guide_to_comments_in_project_the_code [2025/01/16 17:49] – serradfh
+++ guide_to_comments_in_project_the_code [2025/01/21 16:53] (current) – serradfh
@@ Line 1: / Line 1: @@
-===== Guide to comment in the code of PTIDEJ Project =====
+===== Guide comments =====
 While contributing to the project, you may encounter issues that you could ask help from colleagues, with that in mind, a tool to create issues automatically in the github PTIDEJ repository was made.
@@ Line 140: / Line 140: @@
 ====Following is a link of a sample of a issue generated using step 5====
 [[https://github.com/agadfs/Git_PTIDEJ_Issue_Organizer/issues/121|Sample issue]]
+=====Known bugs=====
+===If the step 5 is used to generate the title, and inside a comment is used more than one same Id, if a "// TODO" is not used before every next same Id, will not count towards the title===
+==Example 1==
+<code>
+// TODO
+// @#REFACTOR_CODE Handle a uniform encoding? 4 @#END_REFACTOR
+// the one above was added in the title
+// TODO
+// @#REFACTOR_CODE Handle a uniform encoding? 5 @#END_REFACTOR
+// the one above was added in the title
+</code>
+==Title output of example 1==
+<code>
+Testing on ProxyDisk.java -> 2 Refactor Codes
+</code>
+==Example 2==
+<code>
+// TODO
+// @#REFACTOR_CODE Handle a uniform encoding? 4 @#END_REFACTOR
+// the one above was added in the title
+// @#REFACTOR_CODE Handle a uniform encoding? 5 @#END_REFACTOR
+// will not be added to the title
+</code>
+==Title output of example 2==
+<code>
+Testing on ProxyDisk.java -> 1 Refactor Codes
+</code>
+==Example 3==
+<code>
+// TODO
+// @#REFACTOR_CODE Handle a uniform encoding? 4 @#END_REFACTOR
+// @#REFACTOR_CODE Handle a uniform encoding? 5 @#END_REFACTOR
+// only the first one counted here
+some_method()
+// TODO
+// @#REFACTOR_CODE Handle a uniform encoding? 6 @#END_REFACTOR
+</code>
+==Title output of example 3==
+<code>
+Testing on ProxyDisk.java -> 2 Refactor Codes
+</code>