diff --git a/docs/intro/install.rst b/docs/intro/install.rst index 0b36251cc..c623cdb2f 100644 --- a/docs/intro/install.rst +++ b/docs/intro/install.rst @@ -131,10 +131,16 @@ To install Scrapy on Windows using ``pip``: Now, you should be able to :ref:`install Scrapy ` using ``pip``. .. note:: - **Windows users:** If you see a message like ``'scrapy' is not recognized - as an internal or external command`` after installation, you can run - ``python -m scrapy `` instead (e.g., - ``python -m scrapy startproject myproject``). + + If you see a message like ``'scrapy' is not recognized as an internal or external command`` + when trying to run the ``scrapy`` command-line tool, it usually means that the + Python ``Scripts`` directory is not in your system ``PATH``. + + To make the ``scrapy`` command available, add the ``Scripts`` directory of your + Python installation to the ``PATH`` environment variable. + + As a workaround, you can run ``python -m scrapy `` instead (for example, + ``python -m scrapy startproject myproject``). .. _intro-install-ubuntu: diff --git a/docs/intro/tutorial.rst b/docs/intro/tutorial.rst index 07d31b4da..48a0d15e0 100644 --- a/docs/intro/tutorial.rst +++ b/docs/intro/tutorial.rst @@ -54,10 +54,16 @@ directory where you'd like to store your code and run:: scrapy startproject tutorial .. note:: - **Windows users:** If you see a message like ``'scrapy' is not recognized - as an internal or external command``, you can run - ``python -m scrapy `` instead (e.g., - ``python -m scrapy startproject myproject``). + + If you see a message like ``'scrapy' is not recognized as an internal or external command`` + when trying to run the ``scrapy`` command-line tool, it usually means that the + Python ``Scripts`` directory is not in your ``PATH``. + + To make the ``scrapy`` command available, add the ``Scripts`` directory of + your Python installation to your ``PATH`` environment variable. + + As a workaround, you can run ``python -m scrapy `` instead + (for example, ``python -m scrapy startproject tutorial``). This will create a ``tutorial`` directory with the following contents::