Skip to content

Latest commit

 

History

History
33 lines (25 loc) · 1.04 KB

CommentedCode.md

File metadata and controls

33 lines (25 loc) · 1.04 KB

Commented out code (CommentedCode)

Description

Software modules should not have commented out code fragments, as well as fragments, which are in any way connected with the development process (debugging code, service marks, i.e. !!! _, MRG, etc.) and with specific developers of this code.

For example, it is unacceptable to leave such fragments in the code after debugging or refactoring is completed:

Procedure BeforeDelete(Failure)
    //If True Then
    //  Message("For debugging");
    //EndIf;
EndProcedure

also wrong:

Procedure BeforeDelete(Failure)
    If True Then
        // Ivanov: need fix
    EndIf;
EndProcedure

Correct: after debugging or refactoring is completed, remove the handler BeforeDelete from the code.

ATTENTION:
A code block is considered commented, if at least one line inside the block is defined as code.

Sources