Update the readme

README.md

@@ -2,37 +2,49 @@
 
 ## Overview
 
-Python Environments and Package Manager is a VS Code extension that helps users manage their Python environments and package management. It is a preview extension and the APIs and features are subject to change as the project evolves.
+The Python Environments and Package Manager extension for VS Code helps you manage Python environments and packages using your preferred environment manager backed by its extensible APIs. This extension provides unique support to specify environments for specific files or whole Python folders or projects, including multi-root & mono-repos scenarios.
+
+> Note: This extension is in preview and its APIs and features are subject to change as the project continues to evolve.
 
 ## Features
 
 ### Environment Management
 
-This extension provides an environment view for the user to manage their Python environments. The user can create, delete, and switch between environments. The user can also install and uninstall packages in the current environment. This extension provides APIs for extension developers to contribute environment managers.
+This extension provides an Environments view, which can be accessed via the VS Code Activity Bar, where you can manage your Python environments. Here, you can create, delete, and switch between environments, as well as install and uninstall packages within the selected environment. It also provides APIs for extension developers to contribute their own environment managers.
 
-The extension by uses `venv` as the default environment manager. You can change this by setting the `python-envs.defaultEnvManager` setting to a different environment manager. Following are the out of the box environment managers:
+By default, the extension uses the `venv` environment manager. This default manager determines how environments are created, managed, and where packages are installed. However, users can change the default by setting the `python-envs.defaultEnvManager` to a different environment manager. The following environment managers are supported out of the box:
 
 |Id| name |Description|
 |---|----|--|
 |ms-python.python:venv| `venv` |The default environment manager. It is a built-in environment manager provided by the Python standard library.|
-|ms-python.python:system| System Installed Python | These are python installs on your system. Installed either with your OS, or from python.org, or any other OS package manager |
-|ms-python.python:conda| `conda` |The conda environment manager. It is a popular environment manager for Python.|
+|ms-python.python:system| System Installed Python | These are global Python installs on your system. These are typically installed with your OS, from [python.org](https://www.python.org/), or any other OS package manager. |
+|ms-python.python:conda| `conda` | The [Anaconda](https://www.anaconda.com/) environment manager. |
 
+The environment manager is responsible for specifying which package manager will be used by default to install and manage Python packages within the environment. This ensures that packages are managed consistently according to the preferred tools and settings of the chosen environment manager.
 
 ### Package Management
 
-This extension provides a package view for the user to manage their Python packages. The user can install and uninstall packages in the any environment. This extension provides APIs for extension developers to contribute package managers.
+This extension provides a package view for you to manage, install and uninstall you Python packages in any particular environment. This extension provides APIs for extension developers to contribute package managers.
 
-The extension by uses `pip` as the default package manager. You can change this by setting the `python-envs.defaultPackageManager` setting to a different package manager. Following are the out of the box package managers:
+The extension uses `pip` as the default package manager. You can change this by setting the `python-envs.defaultPackageManager` setting to a different package manager. The following are package managers supported out of the box:
 
 |Id| name |Description|
 |---|----|--|
-|ms-python.python:pip| `pip` |The default package manager. It is a built-in package manager provided by the Python standard library.|
-|ms-python.python:conda| `conda` |The conda package manager. It is a popular package manager for Python.|
+|ms-python.python:pip| `pip` | Pip acts as the default package manager and it's typically built-in to Python.|
+|ms-python.python:conda| `conda` |  The [Anaconda](https://www.anaconda.com/) environment manager. |
+
+## Settings Reference
+
+| Setting (python-envs.) |	Default |	Description |
+| ----- | ----- | -----| 
+| defaultEnvManager | `"ms-python.python:venv"` |	The default environment manager used for creating and managing environments. |
+| defaultPackageManager | `"ms-python.python:pip"` |	The default package manager to use for installing and managing packages. This is often dictated by the default environment manager but can be customized. |
+| pythonProjects | `[]` |	A list of Python workspaces, specified by the path, in which you can set particular environment and package managers. You can set information for a workspace as `[{"path":  "/path/to/workspace", "envManager": "ms-python.python:venv", "packageManager": "ms-python.python:pip"]}`. |
+
 
 ## API Reference
 
-See the `src\api.ts` for the full list of APIs.
+See `src\api.ts` for the full list of APIs.
 
 ## Contributing
 
@@ -61,18 +73,11 @@ contact [[email protected]](mailto:[email protected]) with any additio
 
 ## Data and telemetry
 
-The Microsoft Python Extension for Visual Studio Code collects usage
-data and sends it to Microsoft to help improve our products and
-services. Read our
-[privacy statement](https://privacy.microsoft.com/privacystatement) to
-learn more. This extension respects the `telemetry.enableTelemetry`
-setting which you can learn more about at
-https://code.visualstudio.com/docs/supporting/faq#_how-to-disable-telemetry-reporting.
+The Microsoft Python Extension for Visual Studio Code collects usage data and sends it to Microsoft to help improve our products and services. Read our [privacy statement](https://privacy.microsoft.com/privacystatement) to learn more. This extension respects the `telemetry.enableTelemetry` setting which you can learn more about at https://code.visualstudio.com/docs/supporting/faq#_how-to-disable-telemetry-reporting.
 
 ## Trademarks
 
-This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 
-trademarks or logos is subject to and must follow 
+This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow 
 [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
 Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
 Any use of third-party trademarks or logos are subject to those third-party's policies.