Commit and updating documentation syntax and capitalization for folder doc/source/development

Updating script validate_rst_title_capitalization.py to avoid taking into account titles beginning with ':'

Author: cleconte987

doc/source/development/code_style.rst

@@ -18,8 +18,8 @@ consistent code format throughout the project. For details see the
 Patterns
 ========
 
-Foo.class
--------------
+Using foo.__class__
+-------------------
 
 
 pandas uses 'type(foo)' instead 'foo.__class__' as it is making the code more
@@ -47,8 +47,8 @@ String formatting
 Concatenated strings
 --------------------
 
-F-strings
-~~~~~~~~~
+Using f-strings
+~~~~~~~~~~~~~~~
 
 pandas uses f-strings formatting instead of '%' and '.format()' string formatters.
 

doc/source/development/extending.rst

@@ -95,7 +95,7 @@ on :ref:`ecosystem.extensions`.
 
 The interface consists of two classes.
 
-Class:~pandas.API.extensions.ExtensionDtype
+:class:`~pandas.api.extensions.ExtensionDtype`
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 A :class:`pandas.api.extensions.ExtensionDtype` is similar to a ``numpy.dtype`` object. It describes the
@@ -115,7 +115,7 @@ example ``'category'`` is a registered string accessor for the ``CategoricalDtyp
 
 See the `extension dtype dtypes`_ for more on how to register dtypes.
 
-Class:~pandas.API.extensions.ExtensionArray
+:class:`~pandas.api.extensions.ExtensionArray`
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 This class provides all the array-like functionality. ExtensionArrays are
@@ -139,7 +139,7 @@ and comments contain guidance for properly implementing the interface.
 
 .. _extending.extension.operator:
 
-Class:~pandas.API.extensions.ExtensionArray operator support
+:class:`~pandas.api.extensions.ExtensionArray` operator support
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. versionadded:: 0.24.0

scripts/validate_rst_title_capitalization.py

@@ -177,6 +177,7 @@ def find_titles(rst_file: str) -> Generator[Tuple[str, int], None, None]:
                 len(line_chars) == 1
                 and line_chars.pop() in symbols
                 and len(line) == len(previous_line)
+                and previous_line[0] != ':'
             ):
                 yield re.sub(r"[`\*_]", "", previous_line), i
             previous_line = line
@@ -233,6 +234,8 @@ def main(source_paths: List[str], output_format: str) -> bool:
 
     for filename in find_rst_files(source_paths):
         for title, line_number in find_titles(filename):
+            if ":class" in title:
+                print(title)
             if title != correct_title_capitalization(title):
                 print(
                     f"""{filename}:{line_number}:{err_msg} "{title}" to "{