docs: ignore experiments module. use microsoft python image. add PEP-0008 and packaging guide

Author: praisetompane

.gitignore

@@ -163,3 +163,4 @@ cython_debug/
 .vscode
 
 tools/
+experiments/

Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.11
+FROM mcr.microsoft.com/devcontainers/python:3.11
 
 WORKDIR /python
 

README.md

@@ -19,6 +19,7 @@
 - [standard library reference](https://docs.python.org/3.11/library/index.html)
 - [packaging and distribution](https://packaging.python.org/en/latest/)
   - [python packaging authority](https://www.pypa.io/en/latest/)
+  - https://the-hitchhikers-guide-to-packaging.readthedocs.io/en/latest/
   - [glossary](https://packaging.python.org/en/latest/glossary/)
   - tools:
     - [pip](https://pypi.org/project/pip/)
@@ -39,6 +40,7 @@
 
 ## Use Cases
 - [Applications of Python](https://www.python.org/about/apps/)
+- [Style Guide](https://peps.python.org/pep-0008/)
 
 ## Learning Resources
 - [roadmap](https://roadmap.sh/python)

src/8_compound_statements/8.7._function_definitions/decorator.py

@@ -1,26 +1,26 @@
 """
-  def decorators:
-      - formal: 𝑓: 𝑓 ↦ any 
+def decorators:
+    - formal: 𝑓: 𝑓 ↦ Modified[𝑓]
 
-          - in words: a high order function to modify and execute functions/methods
+        - in words: a high order function to modify and execute functions/methods
 
-      - plain english: syntactic sugar for invoking a high order function directly and returning the parameter function's result.
+    - plain english: syntactic sugar for invoking a high order function directly and returning the parameter function's result.
 
-      - intuition: ???
+    - intuition: ???
 
-      - properties:
-        - specification: https://peps.python.org/pep-0318/
+    - properties:
+      - specification: https://peps.python.org/pep-0318/
 
-      - examples:
-        - see function runtime tracker below: def timed
+    - examples:
+      - see function runtime tracker below: def timed
 
-      - use cases:
-        - aspect orientated programming:
-          - logging
-          
-      - proof: ???
-      
-  References: ???
+    - use cases:
+      - aspect orientated programming:
+        - logging
+
+    - proof: ???
+
+References: ???
 """
 
 import time