Skip to content

Commit d570e50

Browse files
committed
Update docs based on feedback from UX team
1 parent 3f40b10 commit d570e50

File tree

1 file changed

+22
-8
lines changed

1 file changed

+22
-8
lines changed

docs/html/ux_research_design.rst

+22-8
Original file line numberDiff line numberDiff line change
@@ -18,10 +18,14 @@ our work.
1818
How to contribute
1919
-----------------
2020

21+
Participate in UX research
22+
==========================
23+
2124
It is important that we hear from pip users so that we can:
2225

2326
- Understand how pip is currently used by the Python community
24-
- Understand how pip users would *like* pip to behave
27+
- Understand how pip users *need* pip to behave
28+
- Understand how pip users *would like* pip to behave
2529
- Understand pip's strengths and shortcomings
2630
- Make useful design recommendations for improving pip
2731

@@ -34,15 +38,25 @@ We are also looking for users to:
3438
- `Give us feedback about pip's new resolver`_
3539
- `Tell us how pip should handle conflicts with already installed packages when updating other packages`_
3640

41+
Report UX issues
42+
================
43+
44+
If you believe that you have found a user experience bug in pip, or you have
45+
ideas for how pip could be made better for all users, you please file an issue
46+
on the `pip issue tracker`_.
47+
48+
Work on UX issues
49+
=================
3750

38-
Other ways to contribute
39-
========================
51+
You can help improve pip's user experience by `working on UX issues`_.
52+
Issues that are ideal for new contributors are marked with "good first issue".
4053

41-
You can also help by:
54+
Test new features
55+
=================
4256

43-
- Reporting UX issues (or suggesting ideas for improvement) on the `pip issue tracker`_
44-
- `Working on UX issues`_
45-
- Testing new features. Currently, we are looking for users to `test pip's new dependency resolver`_.
57+
You can help the team by testing new features as they are released to the
58+
community. Currently, we are looking for users to
59+
`test pip's new dependency resolver`_.
4660

4761
Next steps
4862
----------
@@ -63,5 +77,5 @@ In the coming months we will extend this documentation to include:
6377
.. _Give us feedback about pip's new resolver: https://tools.simplysecure.org/survey/index.php?r=survey/index&sid=989272&lang=en
6478
.. _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
6579
.. _pip issue tracker: https://github.com/pypa/pip/issues/new
66-
.. _Working on UX issues: https://github.com/pypa/pip/issues?q=is%3Aissue+is%3Aopen+label%3A%22K%3A+UX%22
80+
.. _working on UX issues: https://github.com/pypa/pip/issues?q=is%3Aissue+is%3Aopen+label%3A%22K%3A+UX%22
6781
.. _test pip's new dependency resolver: https://pip.pypa.io/en/latest/user_guide/#changes-to-the-pip-dependency-resolver-in-20-2-2020

0 commit comments

Comments
 (0)