Merge remote-tracking branch 'origin/develop'

Author: nixel2007

docs/en/diagnostics/NestedStatements.md

@@ -1,4 +1,4 @@
-# Managing statements should not not be bested too deep
+# Control flow statements should not be nested too deep
 
 Nested "If", "For", "ForEach", "While" and "Try" operators are key ingredients for so called "spaghetti-code".
 

docs/en/diagnostics/UseLessForEach.md

@@ -0,0 +1,33 @@
+# Useless collection iteration
+
+The absence of an iterator in the loop body indicates either a useless iteration of the collection or an error in the loop body.
+
+Incorrect:
+
+```Bsl
+
+Для Каждого Итератор Из Коллекция Цикл
+
+    ВыполнитьДействиеНадЭлементом(Коллекция);
+    
+КонецЦикла;
+
+```
+
+Correct:
+
+```Bsl
+
+Для Каждого Итератор Из Коллекция Цикл
+
+    ВыполнитьДействиеНадЭлементом(Итератор);
+    
+КонецЦикла;
+
+```
+
+```
+
+ВыполнитьДействиеНадКоллекцией(Коллекция);
+
+```

docs/en/index.md

@@ -126,32 +126,32 @@ Used for code analysis to meet coding standards and search for possible errors.
 
 ### Implemented diagnostics
 
-- [CanonicalSpellingKeywords - Canonical Keywords Spelling ](diagnostics/CanonicalSpellingKeywords.md)
-- [DeprecatedMessage - Restriction on using of the obsolete method "Message"](diagnostics/DeprecatedMessage.md)
-- [EmptyCodeBlock - Empty Code Block](diagnostics/EmptyCodeBlock.md)
-- [EmptyStatement - Empty Statement](diagnostics/EmptyStatement.md)
-- [FunctionShouldHaveReturn - Function Should Have Return](diagnostics/FunctionShouldHaveReturn.md)
-- [IfElseDuplicatedCodeBlockDiagnostic - If...Else Duplicated Code Block](diagnostics/IfElseDuplicatedCodeBlock.md)
-- [IfElseDuplicatedConditionDiagnostic - If...Else Duplicated Condition](diagnostics/IfElseDuplicatedCondition.md)
-- [IfElseIfEndsWithElse - If...ElseIf Ends With Else](diagnostics/IfElseIfEndsWithElse.md)
-- [LineLength - Line Length](diagnostics/LineLength.md)
-- [MethodSize - Method Size](diagnostics/MethodSize.md)
+- [CanonicalSpellingKeywords - Canonical spelling of keywords ](diagnostics/CanonicalSpellingKeywords.md)
+- [DeprecatedMessage - Restriction on the use of deprecated "Message" method](diagnostics/DeprecatedMessage.md)
+- [EmptyCodeBlock - Empty code block](diagnostics/EmptyCodeBlock.md)
+- [EmptyStatement - Empty Ssatement](diagnostics/EmptyStatement.md)
+- [FunctionShouldHaveReturn - Function must have Return statement](diagnostics/FunctionShouldHaveReturn.md)
+- [IfElseDuplicatedCodeBlockDiagnostic - Duplicated code blocks in If...Then...ElsIf...](diagnostics/IfElseDuplicatedCodeBlock.md)
+- [IfElseDuplicatedConditionDiagnostic - Duplicated conditions in If...Then...ElsIf...](diagnostics/IfElseDuplicatedCondition.md)
+- [IfElseIfEndsWithElse - Using If...Then...ElsIf... statement](diagnostics/IfElseIfEndsWithElse.md)
+- [LineLength - Line length restriction](diagnostics/LineLength.md)
+- [MethodSize - Method size restriction](diagnostics/MethodSize.md)
 - [NestedConstructorsInStructureDeclaration - Nested constructors with parameters in structure declaration](diagnostics/NestedConstructorsInStructureDeclaration.md)
-- [NestedStatements - Managing statements should not be nested too deep](diagnostics/NestedStatements.md)
+- [NestedStatements - Control flow statements should not be nested too deep](diagnostics/NestedStatements.md)
 - [NestedTernaryOperator - Nested Ternary Operator](diagnostics/NestedTernaryOperator.md)
-- [NumberOfOptionalParams - Number Of Optional Parameters in Method](diagnostics/NumberOfOptionalParams.md)
-- [NumberOfParams - Number Of Parameters in Method](diagnostics/NumberOfParams.md)
-- [NumberOfValuesInStructureConstructor - Restriction on the number of property values ​​passed to the structure constructor](diagnostics/NumberOfValuesInStructureConstructor.md)
+- [NumberOfOptionalParams - Number of optional method parameters restriction](diagnostics/NumberOfOptionalParams.md)
+- [NumberOfParams - Number of method parameters restriction](diagnostics/NumberOfParams.md)
+- [NumberOfValuesInStructureConstructor - Number of values in structure constructor restriction](diagnostics/NumberOfValuesInStructureConstructor.md)
 - [OneStatementPerLine - One Statement Per Line](diagnostics/OneStatementPerLine.md)
-- [ParseError - Source code parse error](diagnostics/ParseError.md)
-- [OrderOfParams - Order Of Parameters in Method](diagnostics/OrderOfParams.md)
-- [ProcedureReturnsValue - Procedure should not return Value](diagnostics/ProcedureReturnsValue.md)
-- [SemicolonPresence - Statement should end with Semicolon](diagnostics/SemicolonPresence.md)
-- [SelfAssign - Variable is Assigned to itself](diagnostics/SelfAssign.md)
+- [ParseError - Error parsing source code](diagnostics/ParseError.md)
+- [OrderOfParams - Order of method parameters](diagnostics/OrderOfParams.md)
+- [ProcedureReturnsValue - Procedure must have no Return statement](diagnostics/ProcedureReturnsValue.md)
+- [SemicolonPresence - Statement should end with ";"](diagnostics/SemicolonPresence.md)
+- [SelfAssign - Variable self assignment](diagnostics/SelfAssign.md)
 - [TryNumber - Cast to number in try catch block](diagnostics/TryNumber.md)
 - [UnknownPreprocessorSymbol - Unknown Preprocessor Symbol](diagnostics/UnknownPreprocessorSymbol.md)
-- [UseLessForEach - Useless collection iteration](diagnostics/UseLessForEach.md)
-- [UsingCancelParameter - Using Cancel Parameter](diagnostics/UsingCancelParameter.md)
-- [UsingFindElementByString - Using the methods "FindByDescription" and "FindByCode"](diagnostics/UsingFindElementByString.md)
+- [UseLessForEach - Useless For Each loop](diagnostics/UseLessForEach.md)
+- [UsingCancelParameter - Using "Cancel" parameter](diagnostics/UsingCancelParameter.md)
+- [UsingFindElementByString - Restriction on the use of "FindByDescription" and "FindByCode" methods](diagnostics/UsingFindElementByString.md)
 - [UsingServiceTag - Using service tags](diagnostics/UsingServiceTag.md)
-- [YoLetterUsageDiagnostic - Yo Letter Usage in code](diagnostics/YoLetterUsage.md)
+- [YoLetterUsageDiagnostic - Using "Ё" letter in code](diagnostics/YoLetterUsage.md)