updated README and started CHANGELOG and TODO

Jill M. Nolan · Jill M. Nolan · commit 21724509ed21 · 2020-10-29T15:13:24.000-04:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,8 +2,10 @@
 
 All notable changes to the "python-essentials" extension pack will be documented in this file.
 
-Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how to structure this file.
-
-## [Unreleased]
+## 0.0.1
 
 - Initial release
+
+## 0.0.2
+
+- Reorganized the README document by (1) categorizing Extensions alphabetically, (2) reorganizing the Sections, (3) retitle the Sections when appropriate, (4) added YouTube tutorials, (5) added Disclaimer, (6) expanded Notes, (7) referenced Extension Packs published in VSCode Marketplace, (8) reworte Attributions, and (9) added VSCode Tips and Tricks.
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-# README
+# Python Essentials, a Visual Studio Code extension package for Python Development
 
 ## Introduction
 
@@ -8,106 +8,170 @@ Are you tired of reinstalling extensions on each of your computer(s)? How about
 
 Glad, that you've asked! Please find the supervening extensions. Of course, I always love to hear your suggestions to improve this extension package.  To do so, please create a new issue in the [**Issues Section**](https://github.com/jillmnolan/python-essentials/issues). After all, the ultimate goal for this extension pack is **convenience** at the click of one button. 
 
+### Recommended Theme for Python Development
+
 * [**Chromodynamics Theme**](https://marketplace.visualstudio.com/items?itemName=magicstack.Chromodynamics): A **VSCode plugin** extends **Python programming** in **VSCode** through *a highly recommended (at least, from yours truly!)* **dark color scheme** from [**MagicStack**](https://github.com/MagicStack).  **Note:** This works well with [**MagicPython**](https://github.com/MagicStack/MagicPython), which is included below.  :-)
 
+### Recommended Extensions for Python Development
+
+* [**Django**](https://marketplace.visualstudio.com/items?itemName=batisteo.vscode-django): A **VSCode plugin** that provides "beautiful" **syntax** and **scoped snippets**.
+
+* [**Jinja**](https://marketplace.visualstudio.com/items?itemName=wholroyd.jinja): A **VSCode plugin** that supports **Jinja template language** support, including **language colorization** support, including but not limited to **type annotations**, **f-strings**, and **regular expressions**.
+
+* [**Live Share Extension Pack**](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare-pack): An **official VSCode extension pack** that enable real-time collaborative development, including integrated [**audio**](https://marketplace.visualstudio.com/items?itemName=ms-vsliveshare.vsliveshare-audio) and [**text**](https://marketplace.visualstudio.com/items?itemName=ms-vsliveshare.vsliveshare) chat, which supports [**various use cases**](https://docs.microsoft.com/en-us/visualstudio/liveshare/reference/use-cases).
+
+* [**MagicPython**](https://marketplace.visualstudio.com/items?itemName=magicstack.MagicPython): A **VSCode plugin** that supports **preferences** and **syntax highlighter** for "cutting edge" **Python 3**, whereby serving as a **drop-in replacement** for the default **Python package**.
+
 * [**Python**](https://marketplace.visualstudio.com/items?itemName=ms-python.python): An official **Microsoft VSCode plugin** that provides support for the **Python programming language** albeit for all actively supported **versions**: **2.7, >=3.6**, including **Functionalities**, such as:
 
+  * Code Formatting
+
+  * Code Navigation
+
+  * Debugging
+
   * IntelliSense
+
+  * [**Jupyter Notebook**](https://jupyter.org/) Support
   
   * Linting
   
-  * Debugging
-  
-  * Code Navigation
-  
-  * Code Formatting
-  
-  * [**Jupyter Notebook**](https://jupyter.org/) Support
-  
   * Refactoring
-  
-  * Variable Explorer
+
+  * Snippets
   
   * Test Explorer
   
-  * Snippets
-  
- * **Note**: Please be advised that you will need a **Python** distribution.  Depending on what you utilize Python programming for, I can recommend without hesitation either the official [**Python Distribution**](https://www.python.org/) or [**Anaconda**](https://www.anaconda.com/).  **Anaconda** graphical user interace is best for **data science**, **artificial intelligence**, and **machine learning**.  Conversely, the official **Python** distribution is best for application development (desktop, web, or GIS).  I have included the weblinks to the respective homepages, since usually pages are moved and the direct weblink would be dead.  :-(
-
-* [**MagicPython**](https://marketplace.visualstudio.com/items?itemName=magicstack.MagicPython): A **VSCode plugin** that supports **preferences** and **syntax highlighter** for "cutting edge" **Python 3**, whereby serving as a **drop-in replacement** for the default **Python package**.
-
-* [**Jinja**](https://marketplace.visualstudio.com/items?itemName=wholroyd.jinja): A **VSCode plugin** that supports **Jinja template language** support, including **language colorization** support, including but not limited to **type annotations**, **f-strings**, and **regular expressions**. 
-
-* [**Django**](https://marketplace.visualstudio.com/items?itemName=batisteo.vscode-django): A **VSCode plugin** that provides "beautiful" **syntax** and **scoped snippets**.
+  * Variable Explorer
 
-* [**Visual Studio IntelliCode**](https://marketplace.visualstudio.com/items?itemName=VisualStudioExptTeam.vscodeintellicode): A **VSCode plugin** that provides **AI-assisted development features** for **Python**, with **insights** based on understanding your **code context** combined with **machine learning**.
+  * **Note**: Please be advised that you will need a **Python** distribution.  Depending on what you utilize Python programming for, I can recommend without hesitation either the official [**Python Distribution**](https://www.python.org/) or [**Anaconda**](https://www.anaconda.com/).  **Anaconda** graphical user interace is best for **data science**, **artificial intelligence**, and **machine learning**.  Conversely, the official **Python** distribution is best for application development (desktop, web, or GIS).  I have included the weblinks to the respective homepages, since usually pages are moved and the direct weblink would be dead.  :-(
 
 * [**Python Test Explorer for VSCode**](https://marketplace.visualstudio.com/items?itemName=LittleFoxTeam.vscode-python-test-adapter): A **VSCode plugin** which allows you to run your **Python** [**Unitest tests**](https://docs.python.org/3/library/unittest.html#module-unittest) and [**Pytest**](https://docs.pytest.org/en/latest/) in the sidebar, with the assistance of yet another plugin [**Test Explorer UI**](https://marketplace.visualstudio.com/items?itemName=hbenl.vscode-test-explorer). ;-)
 
+* [**Test Explorer Live Share**](https://marketplace.visualstudio.com/items?itemName=hbenl.vscode-test-explorer-liveshare): A VS Code plugin that serves as the "glue" between the previously mentioned [**Test Explorer UI**](https://marketplace.visualstudio.com/items?itemName=hbenl.vscode-test-explorer) and [**Live Share Extension Pack**](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare-pack), respectively.
+
 * [**Test Explorer UI**](https://marketplace.visualstudio.com/items?itemName=hbenl.vscode-test-explorer): A **VSCode plugin** provides an extensible user interface for running tests. **Note**: This plugin works with a corresponding **Test Adapter** plugin, which for this extension pack is: [**Python Test Explorer for VSCode**](https://marketplace.visualstudio.com/items?itemName=LittleFoxTeam.vscode-python-test-adapter).  Moreover, this plugin can  be used in [**Live Share**](https://marketplace.visualstudio.com/items?itemName=ms-vsliveshare.vsliveshare) **sessions** by installing the [**Test Explorer Live Share**](https://marketplace.visualstudio.com/items?itemName=hbenl.vscode-test-explorer-liveshare) plugin.  No worries, this **Extension Pack** got you've covered. :)
 
-* [**Live Share Extension Pack**](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare-pack): An **official VSCode extension pack** that enable real-time collaborative development, including integrated [**audio**](https://marketplace.visualstudio.com/items?itemName=ms-vsliveshare.vsliveshare-audio) and [**text**](https://marketplace.visualstudio.com/items?itemName=ms-vsliveshare.vsliveshare) chat, which supports [**various use cases**](https://docs.microsoft.com/en-us/visualstudio/liveshare/reference/use-cases).
+* [**Visual Studio IntelliCode**](https://marketplace.visualstudio.com/items?itemName=VisualStudioExptTeam.vscodeintellicode): A **VSCode plugin** that provides **AI-assisted development features** for **Python**, with **insights** based on understanding your **code context** combined with **machine learning**.
 
-* [**Test Explorer Live Share**](https://marketplace.visualstudio.com/items?itemName=hbenl.vscode-test-explorer-liveshare): A VS Code plugin that serves as the "glue" between the previously mentioned [**Test Explorer UI**](https://marketplace.visualstudio.com/items?itemName=hbenl.vscode-test-explorer) and [**Live Share Extension Pack**](https://marketplace.visualstudio.com/items?itemName=MS-vsliveshare.vsliveshare-pack), respectively.
+### Descriptions are coming soon for these Extension Packs! :-)
 
-### Descriptions are coming soon! :-)
+* [**AREPL for Python**](https://marketplace.visualstudio.com/items?itemName=almenon.arepl)
 
-* [**PyRight**](https://marketplace.visualstudio.com/items?itemName=ms-pyright.pyright)
+* [**Better Comments**](https://marketplace.visualstudio.com/items?itemName=aaron-bond.better-comments)
 
-* [**Sync Settings**](https://marketplace.visualstudio.com/items?itemName=shan.code-settings-sync)
+* [**Bracket Pair Colorizer 2**](https://marketplace.visualstudio.com/items?itemName=CoenraadS.bracket-pair-colorizer-2)
 
 * [**Code Runner**](https://marketplace.visualstudio.com/items?itemName=formulahendry.code-runner)
 
-* [**Guides**](https://marketplace.visualstudio.com/items?itemName=spywhere.guides)
+* [**Code Spell Checker**](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker)
 
-* [**AREPL for Python**](https://marketplace.visualstudio.com/items?itemName=almenon.arepl)
+* [**EditorConfig for VS Code**](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)
 
-* [**Python Docstring Generator**](https://marketplace.visualstudio.com/items?itemName=njpwerner.autodocstring)
+* [**GitLens — Git supercharged**](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens)
+
+* [**Guides**](https://marketplace.visualstudio.com/items?itemName=spywhere.guides)
 
 * [**Kite Autocomplete for Python and JavaScript**](https://marketplace.visualstudio.com/items?itemName=kiteco.kite)
 
-* [**EditorConfig for VS Code**](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig)
+* [**Markdown All in One**](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)
 
-* [**Code Spell Checker**](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker)
+* [**markdownlint**](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint)
 
-* [**GitLens — Git supercharged**](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens)
+* [**Markdown TOC**](https://marketplace.visualstudio.com/items?itemName=AlanWalk.markdown-toc)
+
+* [**Prettier - Code Formatter**](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)
 
 * [**PyDev**](https://marketplace.visualstudio.com/items?itemName=fabioz.vscode-pydev)
 
+* [**PyRight**](https://marketplace.visualstudio.com/items?itemName=ms-pyright.pyright)
+
+* [**Python Docstring Generator**](https://marketplace.visualstudio.com/items?itemName=njpwerner.autodocstring)
+
+* [**Run on Save**](https://marketplace.visualstudio.com/items?itemName=emeraldwalk.runonsave)
+
+* [**Sync Settings**](https://marketplace.visualstudio.com/items?itemName=shan.code-settings-sync)
+
 * [**TabNine**](https://marketplace.visualstudio.com/items?itemName=TabNine.tabnine-vscode)
 
-* [**Better Comments**](https://marketplace.visualstudio.com/items?itemName=aaron-bond.better-comments)
+* [**WakaTime**](https://marketplace.visualstudio.com/items?itemName=WakaTime.vscode-wakatime)
 
-* [**Bracket Pair Colorizer 2**](https://marketplace.visualstudio.com/items?itemName=CoenraadS.bracket-pair-colorizer-2)
+* [**YAML**](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml)
 
-* [**Markdown All in One**](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one)
+**Please feel free to disable any plugin that you do not wish to have activated from the use of our extension pack. :)**
 
-* [**markdownlint**](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint)
+## Visual Studio Code Tips and Tricks from its Docs
 
-* [**Markdown TOC**](https://marketplace.visualstudio.com/items?itemName=AlanWalk.markdown-toc)
+* Please puruse the [**Visual Studio Code Variables Reference**](https://code.visualstudio.com/docs/editor/variables-reference), if you wish to use **variables substitution**.
 
-* [**Prettier - Code Formatter**](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)
+* VSCode Keyword Shortcuts
 
-* [**Run on Save**](https://marketplace.visualstudio.com/items?itemName=emeraldwalk.runonsave)
+  * [**Linux**](https://code.visualstudio.com/shortcuts/keyboard-shortcuts-linux.pdf): Link contains **PDF**.
 
-* [**YAML**](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-yaml)
+  * [**macOS**](https://code.visualstudio.com/shortcuts/keyboard-shortcuts-macos.pdf): Link contains **PDF**.
 
-* [**WakaTime**](https://marketplace.visualstudio.com/items?itemName=WakaTime.vscode-wakatime)
+  * [**Windows**](https://code.visualstudio.com/shortcuts/keyboard-shortcuts-windows.pdf): Link contains **PDF**.
+
+* Please puruse the [**Visual Studio Code Keybindings**](https://code.visualstudio.com/docs/getstarted/keybindings), if you wish to use **custom keybindings**.
+
+  * [**Optional Keymap Extensions**](https://code.visualstudio.com/docs/getstarted/tips-and-tricks): I recommend the specific keybinding extension that meets your use case through Microsoft, if possible.
+
+* Please puruse the [**Visual Studio Code Tips and Tricks**](https://code.visualstudio.com/docs/getstarted/tips-and-tricks) to make your experience a little bit more enjoyable.
 
 ## Note
 
-It is my pledge to update this Extension Package with update extension as needed to perform the job efficiently and effectively. Likewise, the Extensions list will be categorized accordingly and more detailed information regarding plugins will be incorporated in the near future. Cheers! :)
+It is my pledge to update this Extension Package with update extension as needed to perform the job efficiently and effectively. Likewise, the Extensions list will be categorized accordingly and more detailed information regarding plugins will be incorporated in the near future.  I will certainly be on the lookup for some helpful Python Development hints and tips to make your experience enjoyable. Cheers! :)
+
+## Recommended Tutorials for Visual Studio Code
+
+* [**Visual Studio Code Crash Course**](https://www.youtube.com/watch?v=WPqXP_kLzpo) (1:32:34): Courtesy of [**Mr. James Quick**](https://learn.jamesqquick.com/) from [**FreeCodeCamp.org**](https://www.freecodecamp.org/), whom provided a [**VS Code Cheatsheet**](https://learn.jamesqquick.com/vs-code-cheat-sheet) on his website (**note**: free registration required).
+
+* [**Setting Up VSCode for Python Programming**](https://www.youtube.com/watch?v=W--_EOzdTHk) (22:19): Courtesy of the one and only Mr. Brad Traversy from [**Traversy Media**](https://www.traversymedia.com/).
+
+## Recommended Tutorials on Python
+
+### From Traversy Media
+
+* [**Python Crash Course for Beginners**](https://www.youtube.com/watch?v=JJmcL1N2KQs) (1:35:36) [November 28, 2018]
+
+* [**Pipenv Crash Course**](https://www.youtube.com/watch?v=6Qmnh5C4Pmo&list=PLillGF-RfqbbJYRaNqeUzAb7QY-IqBKRx&index=12) (15:39) [December 23, 2018]
+
+* [**Python and MySQL Crash Course**](https://www.youtube.com/watch?v=BHwgnGEhYG8&list=PLillGF-RfqbbJYRaNqeUzAb7QY-IqBKRx&index=2) (24:38) [June 15, 2020]
+  
+* [**Object Oriented Programming (OOP) in Python**](https://www.youtube.com/watch?v=MikphENIrOo) (43:46) [August 21, 2020]
+
+* [**Python Django Crash Course**](https://www.youtube.com/watch?v=e1IyzVyrLSU&list=PLillGF-RfqbbJYRaNqeUzAb7QY-IqBKRx&index=5) (1:11:50) [September 4, 2019]
+
+### From FreeCodeCamp.org
+
+* [**Learn Python - Full Course for Beginners**](https://www.youtube.com/watch?v=BHwgnGEhYG8&list=PLillGF-RfqbbJYRaNqeUzAb7QY-IqBKRx&index=2) (4:26:51) [July 11, 2018]
+
+* [**Intermediate Python Programming Course**](https://www.youtube.com/watch?v=HGOBQPFzWKo) (5:55:46) [August 27, 2020]
+
+**Please let me know if you know any other _FREE_ Python resources that might benefit others by creating a new issue in the [**Issues Section**](https://github.com/jillmnolan/python-essentials/issues).**
 
 ## Attributions
 
-Thank you for all the developers that built these above referenced extensions.  My genuine appreciaion for your hard work and dedication to the developer community. :)
+Thank you for all the developers that built these above referenced extensions.  My genuine appreciation for your hard work and dedication to the developer community. :)
+
+## Visual Studio Code Extension Packs
+
+* [**COBOL Essentials**](https://marketplace.visualstudio.com/items?itemName=JillMNolan.cobol-essentials): A Visual Studio Code extension for [**Mainframe**](https://www.ibm.com/it-infrastructure/z/education/what-is-a-mainframe) development, particularly [**Mainframe as a Service (MaaS)**](https://watech.wa.gov/sites/default/files/public/Mainframe%20MFaaS%20one%20pager_3-13-20.pdf#:~:text=mainframe%20service%20to%20a%20vendor-managed%20cloud%20solution.%20Definition.,the%20IT%20infrastructure%2C%20support%20and%20maintenance.%20Customers%20pay). Link contains PDF from [**Washington Technology Services**](https://watech.wa.gov/), which provides an example of MaaS.
+
+* [**Java Essentials**](https://marketplace.visualstudio.com/items?itemName=JillMNolan.java-essentials): A Visual Studio Code extension pack for Java development.
+
+* [**.NET Core Essentials**](https://marketplace.visualstudio.com/items?itemName=JillMNolan.dotnet-core-essentials): A Visual Studio Code extension pack for .NET Core development, with special provisions for Azure Cloud development through official Microsoft extensions.
+
+* [**PHP Development Essentials**](https://marketplace.visualstudio.com/items?itemName=JillMNolan.php-development-essentials): A Visual Studio Code extension pack that serves as the comprehensive version of Web Development Essentials pack, which, unlike Web Development Essentials, does not have Angular or React extensions.
+
+* [**Python Essentials**](https://marketplace.visualstudio.com/items?itemName=JillMNolan.python-essentials): This Visual Studio Code Extension Pack is what you are currently seeing. :)
 
-## Published Extensions Packs in VSCode Marketplace
+* [**Web Development Essentials**](https://marketplace.visualstudio.com/items?itemName=JillMNolan.web-development-essentials-pack): A Visual Studio Code extension pack that serves as the condensed version of the PHP Development Essentials pack for Visual Studio Code, whose main premise is centered around JavaScript ecosystem.
 
-* [**.NET Core Essentials**](https://marketplace.visualstudio.com/items?itemName=JillMNolan.dotnet-core-essentials)
+## Disclaimer
 
-* [**Python Essentials**](https://marketplace.visualstudio.com/items?itemName=JillMNolan.python-essentials)
+**Please be advised that this is an "off-the-clock" passion project, whose intent is to be utilized by anyone (including my colleagues) who will derive benefit from this one-click installation of popular extensions that I felt was a relevant theme to this Extension Pack.**
 
-* [**Web Dev Essentials**](https://marketplace.visualstudio.com/items?itemName=JillMNolan.web-dev-essentials)
+## Signing Off
 
 **Please enjoy! Cheers!**
diff --git a/TODO.md b/TODO.md
