First draft

Author: MomIsBestFriend

doc/source/development/contributing.rst

@@ -569,8 +569,8 @@ do not make sudden changes to the code that could have the potential to break
 a lot of user code as a result, that is, we need it to be as *backwards compatible*
 as possible to avoid mass breakages.
 
-Additional standards are outlined on the `code style wiki
-page <https://github.com/pandas-dev/pandas/wiki/Code-Style-and-Conventions>`_.
+Additional standards are outlined on the (Placeholder as a reminder to ask the
+devs for the help on how to properly link the new created file)
 
 Optional dependencies
 ---------------------

doc/source/development/contributing_code_style.rst

@@ -0,0 +1,199 @@
+.. _Not_sure_what_to_put_here:
+
+{{ header }}
+
+=======================
+pandas code style guide
+=======================
+
+.. contents:: Table of contents:
+   :local:
+
+Patterns
+========
+
+foo.__class__
+-------------
+
+*pandas* uses 'type(foo)' instead 'foo.__class__' as it is making the code more
+readable.
+
+For example:
+
+**Good:**
+
+.. code-block:: python
+
+    cls = type(self)
+
+**Good:**
+
+.. code-block:: python
+
+    name = type(self).__name__
+
+**Bad:**
+
+.. code-block:: python
+
+    cls = self.__class__
+
+**Bad:**
+
+.. code-block:: python
+
+    name = self.__class__.__name__
+
+String formatting
+=================
+
+Concatenated strings
+--------------------
+
+f-strings
+~~~~~~~~~
+
+*pandas* uses f-strings formatting instead of '%' and '.format()' string formatters.
+
+The convention of using f-strings on a string that is concatenated over serveral lines,
+is to prefix only the lines containing the value needs to be interpeted.
+
+For example:
+
+**Good:**
+
+.. code-block:: python
+
+    my_warning_message = (
+        f"Warning, {old_function_name} is deprecated, "
+        "please use the new and way better "
+        f"{new_function_name}"
+    )
+
+**Bad:**
+
+.. code-block:: python
+
+    my_warning_message = (
+        f"Warning, {old_function_name} is deprecated, "
+        f"please use the new and way better "
+        f"{new_function_name}"
+    )
+
+White spaces
+~~~~~~~~~~~~
+
+Putting the white space only at the end of the previous line, so
+there is no whitespace at the beggining of the concatenated string.
+
+For example:
+
+**Good:**
+
+.. code-block:: python
+
+    example_string = (
+        "Some long concatenated string, "
+        "with good placement of the "
+        "whitespaces"
+    )
+
+**Bad:**
+
+.. code-block:: python
+
+    example_string = (
+        "Some long concatenated string,"
+        " with bad placement of the"
+        " whitespaces"
+    )
+
+Representation function (aka 'repr()')
+--------------------------------------
+
+*pandas* uses 'repr()' instead of '%r' and '!r'.
+
+The use of 'repr()' will only happend when the value is not an obvious string.
+
+For example:
+
+**Good:**
+
+.. code-block:: python
+
+    raise ValueError(f"Unknown recived value, got: {repr(value)}")
+
+**Good:**
+
+.. code-block:: python
+
+    raise ValueError(f"Unknown recived type, got: '{type(value).__name__}'")
+
+**Bad:**
+
+.. code-block:: python
+
+    raise ValueError(f"Unknown recived type, got: {repr(type(value).__name__)}")
+
+Single and double quotes
+------------------------
+
+*pandas* uses single quotes when ....
+
+For example:
+
+**Good:**
+
+.. code-block:: python
+
+    placeholder = True
+
+
+**Bad:**
+
+.. code-block:: python
+
+    placeholder = True
+
+And using double quotes when....
+
+For example:
+
+**Good:**
+
+.. code-block:: python
+
+    placeholder = True
+
+
+**Bad:**
+
+.. code-block:: python
+
+    placeholder = True
+
+Typing
+======
+
+Annotating __init__
+-------------------
+
+*pandas* does not annotate the '__init__' function. it is redundant
+as almost every '__init__' function will most like not to return anything.
+
+For example:
+
+**Good:**
+
+.. code-block:: python
+
+    def __init__(self, name):
+        self.name = name
+
+**Bad:**
+
+.. code-block:: python
+
+    def __init__(self, name) -> None:
+        self.name = name
+