It would probably be good to add a note in the venv docs about execution policies, why it needs to change for environment activation, and how to do it -- especially now that we sign Activate.ps1 -- so there's less of a chance of people being caught off-guard.

And where this has come up as an issue: https://github.com/microsoft/vscode-python/issues/2559.

https:/go.microsoft.com/fwlink/?LinkID=135170 is the link to the MS docs.

The command is:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Where would we like to put this information?

My proposal would be to add this in a combination of places:

1. Add a further note near the symlinks on Windows comment in this document: `Doc\using\venv-create.inc`

2. Add a blurb in the Activate.ps1 script itself, so that any user can see it very near where the problem might occur. `Lib\venv\scripts\common\Activate.ps1`

I'd probably put something like the following in there:
---

.. note::
   On Microsoft Windows, it may be required to enable the ``Activate.ps1``
   script by setting the execution policy for the user. You can do this by
   issuing the following Powershell command from a Powershell command window:

   PS C:\Users\user> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

   See `About Execution Policies 
   <https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7>`_
   for more information.

---

(This would exist as a ".Notes" section in the Activate.ps1 script)


What do folks think?

All sound reasonable, Derek.

New changeset 45217af29c7f380089af17beb48a5ea0560bbb9d by Derek Keeler in branch 'master':
bpo-38972: Link to instructions to change PowerShell execution policy (GH-19131)
https://github.com/python/cpython/commit/45217af29c7f380089af17beb48a5ea0560bbb9d

New changeset b7345c24a4d962e2adbafc86e4af77de9e3ef09e by Miss Islington (bot) in branch '3.8':
bpo-38972: Link to instructions to change PowerShell execution policy (GH-19131)
https://github.com/python/cpython/commit/b7345c24a4d962e2adbafc86e4af77de9e3ef09e

New changeset ef16958d17e83723334a51428f410f726d6492a7 by Miro Hrončok in branch 'master':
bpo-38972: Fix typos in PowerShell Execution Policies links (GH-20383)
https://github.com/python/cpython/commit/ef16958d17e83723334a51428f410f726d6492a7

New changeset 331b2dfadb2a5dd990145c043d006166e568af7b by Miss Islington (bot) in branch '3.8':
bpo-38972: Fix typos in PowerShell Execution Policies links (GH-20383)
https://github.com/python/cpython/commit/331b2dfadb2a5dd990145c043d006166e568af7b

New changeset 20b2bf318345170502b9840673594a5a12a40829 by Miss Islington (bot) in branch '3.9':
bpo-38972: Fix typos in PowerShell Execution Policies links (GH-20383)
https://github.com/python/cpython/commit/20b2bf318345170502b9840673594a5a12a40829