Update readme based on most recent updates #368
Conversation
There was a problem hiding this comment.
Pull Request Overview
This PR updates the README to reflect recent changes in the extension's feature set and documentation. Key changes include:
- Revision of the extension title and description to remove "Package Manager" and improve clarity.
- Updates to the Features, Command Reference, Settings Reference, and API Reference sections with new content and formatting.
- Minor adjustments to image URL formatting and hyperlink styling.
Comments suppressed due to low confidence (1)
README.md:9
- There is a repeated phrase 'activated terminals Activate terminals'. Please remove the redundant text for clarity.
+- ✅ Create activated terminals Activate terminals
| <img src=<https://raw.githubusercontent.com/microsoft/vscode-python-environments/main/images/python-envs-overview.gif> width=734 height=413> | ||
|
|
||
| ### Environment Management | ||
|
|
||
| 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 Python Environments panel provides an interface to create, delete and manage environments. | ||
|
|
||
| <img src=<https://raw.githubusercontent.com/microsoft/vscode-python-environments/main/images/environment-managers-quick-start.png> width=734 height=413> |
There was a problem hiding this comment.
The image source attribute uses nested angle brackets. Consider removing the extra angle brackets to ensure consistent Markdown/HTML rendering.
| > Important: This extension currently requires the pre-release version of the Python extension (ms-python.python) to operate (version 2024.23.2025010901 or later). | ||
| > **Note:** This extension is in preview, and its APIs and features are subject to change as the project evolves. | ||
|
|
||
| > **Important:** This extension requires the pre-release version of the Python extension (`ms-python.python`) to operate (version 2024.23.2025010901 or later). |
There was a problem hiding this comment.
This was needed originally when we published the first version back in December. I think all we need to say now is that we need v2024.23 or greater.
| ## Features | ||
|
|
||
| <img src=https://raw.githubusercontent.com/microsoft/vscode-python-environments/main/images/python-envs-overview.gif width=734 height=413> | ||
| The "Python Projects" fold shows you all of the projects that are currently in your workspace and their selected environments. From this view you can add more files or folders as projects, select a new environment for your project, and manage your selected environments. |
There was a problem hiding this comment.
We should elaborate that a project in this case is anything that requires its own python environment.
There was a problem hiding this comment.
I go into detail about a project starting on line 59, is this ok?
No description provided.