Index: docs/clang-tidy/index.rst
===================================================================
--- docs/clang-tidy/index.rst
+++ docs/clang-tidy/index.rst
@@ -48,6 +48,8 @@
available checks or with any other value of ``-checks=`` to see which checks are
enabled by this value.
+:: _checks-groups-table:
+
There are currently the following groups of checks:
====================== =========================================================
@@ -338,30 +340,14 @@
.. _LLVM Coding Standards: http://llvm.org/docs/CodingStandards.html
.. _LLVM Phabricator: http://llvm.org/docs/Phabricator.html
+Next, you need to decide which module the check belongs to. Modules
+are located in subdirectories of
+``clang-tidy/ ``_
+and contain checks targeting a certain aspect of code quality (performance,
+readability, etc.), certain coding style or standard (Google, LLVM, CERT, etc.)
+or a widely used API (e.g. MPI). Their names are same as user-facing check
+groups names described :ref:`above `.
-Next, you need to decide which module the check belongs to. If the check
-verifies conformance of the code to a certain coding style, it probably deserves
-a separate module and a directory in ``clang-tidy/``. There are already modules
-implementing checks related to:
-
-* `C++ Core Guidelines
- `_
-* `CERT Secure Coding Standards
- `_
-* `Google Style Guide
- `_
-* `LLVM Style
- `_
-* `modernizing C/C++ code
- `_
-* potential `performance problems
- `_
-* various `readability issues
- `_
-* and `miscellaneous checks
- `_
- that we couldn't find a better category for.
-
After choosing the module, you need to create a class for your check:
.. code-block:: c++