Expand UX documentation to include 2020 research

[nlhkabu]

Preview
https://pip--10745.org.readthedocs.build/en/10745/ux-research-design/

TODO

• Cleanup markdown
• Ensure all links are working and point to the right place
• Make sure images and working, including alt-text

[brainwane]

@ei8fdb it would be wonderful if you could also add in the UX training materials from the trainings you led at the end of 2020 and the start of 2021. Thank you!

[brainwane]

By the way, I'm about to link to this in a blog post since it's (I think) the only place this valuable information is. Looking forward to the merge!

[nlhkabu]

@brainwane you've motivated me to get this merged!

Do you have much experience with RST? It's driving me a bit nuts - I have this TOC

```{toctree}
about-our-users
ci-cd
improving-pip-documentation
mental-models
override-conflicting-dependencies
personas
pip-force-reinstall
pip-logo
pip-search
pip-upgrade-conflict
prioritizing-features
users-and-security
```

But it's not producing the links in the menu:

any ideas what I am doing wrong here? Otherwise @pradyunsg are you able to point me in the right direction?

[pradyunsg]

The toctree needs to be at the "top level" of the document -- i.e. in the first heading or before it. That might be implicated in the behaviour you're seeing?

[brainwane]

[I posted "User Support, Equanimity, And Potential Cross-Project Tools and Practices in Open Source" and linked to the Read the Docs build of this PR in the section "Shared user experience research efforts".]

[konstin]

Is there still interest in merging this? There's so much important research in here that would otherwise be lost. I read through all the pages on the docs preview and at least in that they looked ready to me

[jvns]

I noticed that all of the "write up" links in the surveys section here are 404s, I would love to read those!

[nlhkabu]

Just 2.5 years later... this PR is now ready to merge.

Thanks @konstin and @jvns for the motivation to clean this up - I hope you find the content valuable.

@pradyunsg the commit history on this PR is a complete mess - if you wouldn't mind squashing the commits when you merge into main, that would be much appreciated.

[pfmoore]

Just a couple of minor points. I haven't reviewed the main part of the docs, but +1 on getting this landed. It's easy enough to do follow up PRs if changes are needed.

[pfmoore]

Is the mailing list still active? I notice that the link on that page for more information is broken.

[pradyunsg]

It is. I'll fix the link on the mailing list description. :)

[nlhkabu]

Hoorah! 🕺 Thank you both for the quick review. I am very happy to have this merged :)

[brainwane]

Thank you @nlhkabu @pradyunsg @pfmoore for your work getting this finished and merged! It's such valuable knowledge, not just to pip, and not just to Python packaging, but also as a model for other developer tools, command-line tools, and open source projects more widely. I'm so glad to be able to more easily share this work!

cc @ei8fdb @georgiamoon [blast from the past!]