docs: Add back missing snippets

Author: pawamoy

config/flake8.ini

@@ -1,5 +1,5 @@
 [flake8]
-exclude = fixtures,site
+exclude = fixtures,site,snippets
 max-line-length = 132
 docstring-convention = google
 ban-relative-imports = true

docs/snippets/function_annotations_google.py

@@ -0,0 +1,17 @@
+from typing import Optional
+
+
+def my_function(param1: int, param2: Optional[str] = None) -> str:
+    """A short description of this function.
+
+    Arguments:
+        param1: An integer?
+        param2: A string? If you have a long description,
+            you can split it on multiple lines.
+            Just remember to indent those lines consistently.
+
+            Complex markup is supported in sections items.
+
+                I'm a code block!
+    """
+    return f"{param2}{param1}"

docs/snippets/function_annotations_rst.py

@@ -0,0 +1,15 @@
+from typing import Optional
+
+
+def my_function(param1: int, param2: Optional[str] = None) -> str:
+    """A short description of this function.
+
+    Complex markup is supported in the main description section.
+
+        I'm a code block!
+
+    :param param1: An integer?
+    :param param2: A string? If you have a long description,
+        you can split it on multiple lines.
+    """
+    return f"{param2}{param1}"

mkdocs.yml

@@ -73,6 +73,9 @@ plugins:
       python:
         import:
         - https://mkdocstrings.github.io/objects.inv
+        setup_commands:
+        - import sys
+        - sys.path.append("docs")
     watch:
     - src/mkdocstrings