more docs updating

Author: kenerwin88

.vscode/settings.json

@@ -0,0 +1,82 @@
+{
+  "files.exclude": {
+    "**/.DS_Store": true,
+    "**/__pycache__/": true,
+    "**/*.py[cod]": true,
+    "**/*$py.class": true,
+    "**/*.so": true,
+    "**/.Python": true,
+    "**/build/": true,
+    "**/develop-eggs/": true,
+    "**/dist/": true,
+    "**/downloads/": true,
+    "**/eggs/": true,
+    "**/.eggs/": true,
+    "**/lib/": true,
+    "**/lib64/": true,
+    "**/parts/": true,
+    "**/sdist/": true,
+    "**/var/": true,
+    "**/wheels/": true,
+    "**/pip-wheel-metadata/": true,
+    "**/share/python-wheels/": true,
+    "**/*.egg-info/": true,
+    "**/.installed.cfg": true,
+    "**/*.egg": true,
+    "**/MANIFEST": true,
+    "**/*.manifest": true,
+    "**/*.spec": true,
+    "**/pip-log.txt": true,
+    "**/pip-delete-this-directory.txt": true,
+    "**/htmlcov/": true,
+    "**/.tox/": true,
+    "**/.nox/": true,
+    "**/.coverage": true,
+    "**/.coverage.*": true,
+    "**/.cache": true,
+    "**/nosetests.xml": true,
+    "**/coverage.xml": true,
+    "**/*.cover": true,
+    "**/*.py,cover": true,
+    "**/.hypothesis/": true,
+    "**/.pytest_cache/": true,
+    "**/pytestdebug.log": true,
+    "**/*.mo": true,
+    "**/*.pot": true,
+    "**/*.log": true,
+    "**/local_settings.py": true,
+    "**/db.sqlite3": true,
+    "**/db.sqlite3-journal": true,
+    "**/instance/": true,
+    "**/.webassets-cache": true,
+    "**/.scrapy": true,
+    "**/docs/_build/": true,
+    "**/doc/_build/": true,
+    "**/target/": true,
+    "**/.ipynb_checkpoints": true,
+    "**/profile_default/": true,
+    "**/ipython_config.py": true,
+    "**/.python-version": true,
+    "**/__pypackages__/": true,
+    "**/celerybeat-schedule": true,
+    "**/celerybeat.pid": true,
+    "**/*.sage.py": true,
+    "**/.env": true,
+    "**/.venv": true,
+    "**/env/": true,
+    "**/venv/": true,
+    "**/ENV/": true,
+    "**/env.bak/": true,
+    "**/venv.bak/": true,
+    "**/.spyderproject": true,
+    "**/.spyproject": true,
+    "**/.ropeproject": true,
+    "site": true,
+    "**/.mypy_cache/": true,
+    "**/.dmypy.json": true,
+    "**/dmypy.json": true,
+    "**/.pyre/": true,
+    "**/.pytype/": true,
+    ".pytest_cache/**/*": true
+  }
+}

README.md

@@ -3,7 +3,7 @@
 </a>
 
 # Perfect Python Project
-
+[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/aws/aws-cdk)
 This project is used to demonstrate my idea of a perfect Python project
 configuration. Nearly everthing I've chosen can be bikeshedded for hours or
 days, but feel free to submit a PR if you can back up your suggestions with
@@ -18,9 +18,11 @@ evidence. 😊
 - Latest version of Python (3.8.5)
 - Latest version of Poetry ()
 
-## Installing PyEnv
+## Install PyEnv
 
-For installing Python, you should you PyEnv, regardless of operating system. PyEnv will allow you to easily switch versions of Python. In a perfect world, everyone would be on the latest version, but often we don't have the luxury.
+For installing Python, you should you PyEnv, regardless of operating system. 
+PyEnv will allow you to easily switch versions of Python. In a perfect world, 
+everyone would be on the latest version, but often we don't have the luxury.
 
 ### OSX
 
@@ -29,20 +31,49 @@ For installing Python, you should you PyEnv, regardless of operating system. PyE
 ```bash
 brew update
 brew install pyenv
+echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc # Add pyenv to Path
+echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc # Or .bashrc,. .bash_profile, etc. if not using ZSH
+echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n  eval "$(pyenv init -)"\nfi' >> ~/.zshrc # Autocompletion, requires shell restart
+```
 
-# Add pyenv to Path
-# Or .bashrc,. .bash_profile, etc. if not using ZSH
-echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
-echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
-# Autocompletion, requires shell restart
-echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n  eval "$(pyenv init -)"\nfi' >> ~/.zshrc
+### Windows PowerShell
+[(You are using Chocolatey right?)](https://chocolatey.org/ "Package Manager for Windows")
+**NOTE: ** You should just move to WSL, trust me, the sooner you do it the better everything will be. :) 
+```powershell
+choco install pyenv-win
+# Restart PowerShell
+pyenv update # To get the latest versions of Python, otherwise you won't see 3.8.5
+```
+
+### Linux, Windows WSL
+```bash
+git clone https://github.com/pyenv/pyenv.git ~/.pyenv
+echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc  # Add pyenv to Path
+echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc # Or .bashrc,. .bash_profile, etc. if not using ZSH
+echo -e 'if command -v pyenv 1>/dev/null 2>&1; then\n  eval "$(pyenv init -)"\nfi' >> ~/.zshrc # Autocompletion, requires shell restart
 ```
 
-### Windows
 
-## Installing Python
+## Install Python
+Time to install the latest version of Python!
 
 ```bash
 pyenv install 3.8.5
 pyenv global 3.8.5 # Sets python and python3 globally to point to 3.8.5
+# Let's verify 3.8.5 is set globally, close whatever terminal you are using, then run:
+python --version # This should say 3.8.5, great job!
 ```
+
+## Install Poetry
+Poetry is a fantastic package manager for Python. 
+
+### OSX, Linux, Windows WSL
+```bash
+curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python
+echo 'source $HOME/.poetry/env' >> ~/.zshrc
+```
+
+### Windows PowerShell
+```powershell
+(Invoke-WebRequest -Uri https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py -UseBasicParsing).Content | python
+```