Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add ux docs to pip documentation #8807

Merged
merged 3 commits into from
Sep 2, 2020
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/html/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ Please take a look at our documentation for how to install and use pip:
user_guide
reference/index
development/index
ux_research_design
news

In 2020, we're working on improvements to the heart of pip. Please `learn more and take our survey`_ to help us do it right.
Expand Down
67 changes: 67 additions & 0 deletions docs/html/ux_research_design.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
====================
UX Research & Design
====================

Over the course of 2020, the pip team has been working on improving pip's user
experience.

Currently, our focus is on:

1. `Understanding who uses pip`_
2. `Understanding how pip compares to other package managers, and how pip supports other Python packaging tools`_
3. `Understanding how pip's functionality is used, and how it could be improved`_
4. `Understanding how pip's documentation is used, and how it could be improved`_

You can read the `overall plan`_ and the `mid-year update`_ to learn more about
our work.

How to contribute
-----------------
pradyunsg marked this conversation as resolved.
Show resolved Hide resolved

It is important that we hear from pip users so that we can:

- Understand how pip is currently used by the Python community
- Understand how pip users would *like* pip to behave
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd put "Understand how pip users need pip to behave" before "Understand how pip users would like pip to behave".

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Understand how pip users would *like* pip to behave
- Understand how pip users need pip to behave
- Understand how pip users would *like* pip to behave

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ei8fdb like this?

- Understand pip's strengths and shortcomings
- Make useful design recommendations for improving pip

If you are interested in participating in pip user research, please
`join pip's user panel`_.
You can `read more information about the user panel here`_.

We are also looking for users to:

- `Give us feedback about pip's new resolver`_
- `Tell us how pip should handle conflicts with already installed packages when updating other packages`_


Other ways to contribute
========================

You can also help by:

- Reporting UX issues (or suggesting ideas for improvement) on the `pip issue tracker`_
- `Working on UX issues`_
- Testing new features. Currently, we are looking for users to `test pip's new dependency resolver`_.

Next steps
----------

In the coming months we will extend this documentation to include:

1. Summaries of our user research, including recommendations for how to improve pip
2. Tools for the pip team to continue to practice user centered design (e.g. user personas, etc.)

.. _Understanding who uses pip: https://github.com/pypa/pip/issues/8518
.. _Understanding how pip compares to other package managers, and how pip supports other Python packaging tools: https://github.com/pypa/pip/issues/8515
.. _Understanding how pip's functionality is used, and how it could be improved: https://github.com/pypa/pip/issues/8516
.. _Understanding how pip's documentation is used, and how it could be improved: https://github.com/pypa/pip/issues/8517
.. _overall plan: https://wiki.python.org/psf/Pip2020DonorFundedRoadmap
.. _mid-year update: http://pyfound.blogspot.com/2020/07/pip-team-midyear-report.html
.. _join pip's user panel: https://tools.simplysecure.org/survey/index.php?r=survey/index&sid=827389&lang=en
.. _read more information about the user panel here: https://bit.ly/pip-ux-studies
.. _Give us feedback about pip's new resolver: https://tools.simplysecure.org/survey/index.php?r=survey/index&sid=989272&lang=en
.. _Tell us how pip should handle conflicts with already installed packages when updating other packages: https://docs.google.com/forms/d/1KtejgZnK-6NPTmAJ-7aWox4iktcezQauW-Mh3gbnydQ/edit
.. _pip issue tracker: https://github.com/pypa/pip/issues/new
.. _Working on UX issues: https://github.com/pypa/pip/issues?q=is%3Aissue+is%3Aopen+label%3A%22K%3A+UX%22
.. _test pip's new dependency resolver: https://pip.pypa.io/en/latest/user_guide/#changes-to-the-pip-dependency-resolver-in-20-2-2020
1 change: 1 addition & 0 deletions news/8807.doc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Add ux documentation