docs: Provide guidance on using direnv

docs/integration/editor/pycharm.md

@@ -129,3 +129,9 @@ lint = { features = ["lint"], no-default-feature = true }
 
 Now you as a user can run `pixi shell`, which will start the default environment.
 In production, you then just run `pixi run -e prod COMMAND`, and the minimal prod environment is installed.
+
+## Activate the `pixi` project environment
+
+An alternative approach is to use [`direnv`](../third_party/direnv.md) via a 
+[Jetbrains `direnv` plugin](https://plugins.jetbrains.com/plugin/15285-direnv-integration)
+which can be used to activate `pixi`.

docs/integration/editor/vscode.md

@@ -0,0 +1,12 @@
+[VSCode](https://code.visualstudio.com/) is a popular develop environment.
+
+To use pixi inside of vscode, follow these steps:
+
+* Create a `pixi.toml` file.
+
+See [`direnv`](../third_party/direnv.md).
+* Install `direnv`.
+* Add an `.envrc` to the project.
+
+This [vscode extension](https://marketplace.visualstudio.com/items?itemName=mkhl.direnv).
+* Install the `direnv` vscode extension

docs/integration/third_party/direnv.md

@@ -34,3 +34,8 @@ direnv: unloading
 $ which python
 python not found
 ```
+
+While `direnv` comes with [hooks for the common shells](https://direnv.net/docs/hook.html), 
+these hooks into the shell should not be relied on when using and IDE.
+The `direnv` package does not include hooks for integrated develop environments.
+That said there is typically, a plugin or extension available.

mkdocs.yml

@@ -202,6 +202,7 @@ plugins:
         "ide_integration/pycharm.md": "integration/editor/pycharm.md"
         "ide_integration/r_studio.md": "integration/editor/r_studio.md"
         "ide_integration/devcontainer.md": "integration/editor/devcontainer.md"
+        "ide_integration/vscode.md": "integration/editor/vscode.md"
         "advanced/authentication.md": "deployment/authentication.md"
         "advanced/channel_priority.md": "advanced/channel_logic.md"
         "advanced/github_actions.md": "integration/ci/github_actions.md"