diff --git a/docs/html/user_guide.rst b/docs/html/user_guide.rst index 8711f0f9126..61200522889 100644 --- a/docs/html/user_guide.rst +++ b/docs/html/user_guide.rst @@ -37,6 +37,26 @@ to your system, which can be run from the command prompt as follows: ``py -m pip`` executes pip using the latest Python interpreter you have installed. For more details, read the `Python Windows launcher`_ docs. +.. note:: + + *Quick example for beginners* + + To install a real package using pip, try the following example: + + .. tab:: Unix/macOS + + .. code-block:: shell + python -m pip install requests + This installs the popular `requests` library using the Python + interpreter currently in use. + + .. tab:: Windows + + .. code-block:: shell + py -m pip install requests + This installs the `requests` library using the latest Python + interpreter available on your system. + Installing Packages =================== @@ -1300,4 +1320,4 @@ announcements on the `low-traffic packaging announcements list`_ and .. _`0-using-system-trust-stores-for-verifying-https`: .. rubric:: Using system trust stores for verifying HTTPS -This is now covered in :doc:`topics/https-certificates`. +This is now covered in :doc:`topics/https-certificates`. \ No newline at end of file diff --git a/news/13690.doc.rst b/news/13690.doc.rst new file mode 100644 index 00000000000..2bf680a8bb3 --- /dev/null +++ b/news/13690.doc.rst @@ -0,0 +1,2 @@ +### Added +- beginner example for Running pip section in user guide (#13690) — Mennaalazaz \ No newline at end of file