Update optional-parameters.md

Author: estevao-schultz-neto-SAP

docs/checks/optional-parameters.md

@@ -1,34 +1,20 @@
-# code pal for ABAP
-
 [code pal for ABAP](../../README.md) > [Documentation](../check_documentation.md) > [Optional Parameters](optional-parameters.md)
 
 ## Optional Parameters
 
 ### What is the Intent of the Check?
 
-Avoid usage of `OPTIONAL` parameters because they confuse callers:
+This check searches for OPTIONAL parameter in method signatures. It is recommended to avoid the usage of `OPTIONAL` parameters because they might confuse the consumers of the class:
 
-* Which ones are really required?
-* Which combinations are valid?
-* Which ones exclude each other?
+* Which parameters are really required?
+* Which combination of parameters are valid?
+* Which parameters exclude each other?
 
 Multiple methods with specific parameters for the use case avoid this confusion by giving clear guidance which parameter combinations are valid and expected.
 
 ### How to solve the issue?
 
-Splitting methods instead of adding `OPTIONAL` parameters.
-
-### What to do in case of exception?
-
-You can suppress Code Inspector findings generated by this check using the pseudo comment `"#EC OPTL_PARAM`.  
-The pseudo comment has to be placed after the method declaration.
-
-```abap
-  METHODS do_one_or_the_other
-    IMPORTING
-      what_i_need    TYPE string OPTIONAL
-      something_else TYPE i OPTIONAL. "#EC OPTL_PARAM
-```
+Splitting methods (creating new ones) instead of adding `OPTIONAL` parameters.
 
 ### Example
 
@@ -48,6 +34,17 @@ After the check:
   METHODS do_another_thing IMPORTING something_else TYPE i.
 ```
 
+### What to do in case of exception?
+
+In exceptional cases, you can suppress this finding by using the pseudo comment `"#EC OPTL_PARAM` which should to be placed after the method declaration:
+
+```abap
+  METHODS do_one_or_the_other
+    IMPORTING
+      what_i_need    TYPE string OPTIONAL
+      something_else TYPE i OPTIONAL. "#EC OPTL_PARAM
+```
+
 ### Further Readings & Knowledge
 
 * [ABAP Styleguides on Clean Code](https://github.com/SAP/styleguides/blob/master/clean-abap/CleanABAP.md#split-methods-instead-of-adding-optional-parameters)