[doc] Move the naming-style documentation to invalid-name doc (#6669)

Add a '.gitkeep' in user_guide/configuration

In order for the directory to exists so pylint_options
do not need to create the directory.

Author: Pierre-Sassoulas

doc/conf.py

@@ -62,6 +62,7 @@
     "messages/messages_list": "../user_guide/messages/messages_overview.html",
     "user_guide/message-control": "messages/message_control.html",
     "technical_reference/c_extensions": "../user_guide/messages/error/no-member.html",
+    "user_guide/configuration/naming-styles": "../user_guide/messages/convention/invalid-name.html",
     "development/testing": "tests/index.html",
 }
 

doc/data/messages/i/invalid-name/bad.py

@@ -0,0 +1,8 @@
+class cat:  # [invalid-name]
+
+    def Meow(self, NUMBER_OF_MEOW):  # [invalid-name, invalid-name]
+        print("Meow" * NUMBER_OF_MEOW)
+        return NUMBER_OF_MEOW
+
+
+Cat = cat().Meow(42)  # [invalid-name]

doc/user_guide/configuration/naming-styles.rst renamed to doc/data/messages/i/invalid-name/details.rst

@@ -1,12 +1,3 @@
-.. -*- coding: utf-8 -*-
-
-===============
- Naming styles
-===============
-
-Introduction
-~~~~~~~~~~~~
-
 Pylint recognizes a number of different name types internally. With a few
 exceptions, the type of the name is governed by the location the assignment to a
 name is found in, and not the type of object assigned.

doc/data/messages/i/invalid-name/good.py

@@ -0,0 +1,8 @@
+class Cat:
+
+    def meow(self, number_of_meow):
+        print("Meow" * number_of_meow)
+        return number_of_meow
+
+
+CAT = Cat().meow(42)

doc/user_guide/configuration/.gitkeep

@@ -7,4 +7,3 @@ Configuration
    :titlesonly:
 
    configuration/all-options
-   configuration/naming-styles