Help: Wording, formatting and ordering fixes for SKIP_LINTING docs

Amends b480315e0c2 (TargetGenerator: Add SKIP_LINTING source property,
2023-05-12).

1 files changed, 12 insertions, 12 deletions

diff --git a/Help/prop_sf/SKIP_LINTING.rst b/Help/prop_sf/SKIP_LINTING.rst
index 2be47cb..19592a8 100644
--- a/Help/prop_sf/SKIP_LINTING.rst
+++ b/Help/prop_sf/SKIP_LINTING.rst
@@ -7,18 +7,18 @@ This property allows you to exclude a specific source file
 from the linting process. The linting process involves running
 tools such as :prop_tgt:`<LANG>_CPPLINT`, :prop_tgt:`<LANG>_CLANG_TIDY`,
 :prop_tgt:`<LANG>_CPPCHECK`, and :prop_tgt:`<LANG>_INCLUDE_WHAT_YOU_USE`
-on the source files. By setting `SKIP_LINTING` on a source file,
+on the source files. By setting ``SKIP_LINTING`` on a source file,
 the mentioned linting tools will not be executed for that
 particular file.
 
-EXAMPLE
+Example
 ^^^^^^^
 
-Consider a `C++` project that includes multiple source files,
-such as `main.cpp`, `things.cpp`, and `generatedBindings.cpp`.
-In this example, you want to exclude the `generatedBindings.cpp`
+Consider a C++ project that includes multiple source files,
+such as ``main.cpp``, ``things.cpp``, and ``generatedBindings.cpp``.
+In this example, you want to exclude the ``generatedBindings.cpp``
 file from the linting process. To achieve this, you can utilize
-the `SKIP_LINTING` property with the `set_source_files_properties`
+the ``SKIP_LINTING`` property with the :command:`set_source_files_properties`
 command as shown below:
 
 .. code-block:: cmake
@@ -29,13 +29,13 @@ command as shown below:
       SKIP_LINTING ON
   )
 
-In the provided code snippet, the `SKIP_LINTING` property is set to `ON`
-for the `generatedBindings.cpp` source file. As a result, when the linting
-tools, such as :prop_tgt:`<LANG>_CPPLINT`, :prop_tgt:`<LANG>_CLANG_TIDY`,
-:prop_tgt:`<LANG>_CPPCHECK`, and :prop_tgt:`<LANG>_INCLUDE_WHAT_YOU_USE`,
-are executed, they will skip analyzing the `generatedBindings.cpp` file.
+In the provided code snippet, the ``SKIP_LINTING`` property is set to true
+for the ``generatedBindings.cpp`` source file. As a result, when the linting
+tools specified by :prop_tgt:`<LANG>_CPPLINT`, :prop_tgt:`<LANG>_CLANG_TIDY`,
+:prop_tgt:`<LANG>_CPPCHECK`, or :prop_tgt:`<LANG>_INCLUDE_WHAT_YOU_USE`
+are executed, they will skip analyzing the ``generatedBindings.cpp`` file.
 
-By using the `SKIP_LINTING` property, you can selectively exclude specific
+By using the ``SKIP_LINTING`` property, you can selectively exclude specific
 source files from the linting process. This allows you to focus the
 linting tools on the relevant parts of your project, enhancing the efficiency
 and effectiveness of the linting workflow.