guide_to_comments_in_project_the_code
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
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. | 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==== | ====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]] | [[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> | ||
guide_to_comments_in_project_the_code.1737049781.txt.gz ยท Last modified: 2025/01/16 17:49 by serradfh
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
