ruff's docs optimization suggestions

[d0lwl0b]

While working through the documentation I noticed a small friction point and wanted to share some constructive feedback.

look:

• https://docs.astral.sh/ruff/
• https://docs.astral.sh/ruff/tutorial/

---

1. uv-Centric Examples Feel Heavy for Newcomers

• The quick-start guide and several tutorials rely on uv for installation and running examples.
• New users who have never encountered uv (or any alternative package manager) may feel obliged to adopt an entirely new tool chain before they can even try Ruff.
• A simpler pip install ruff (or “pick your preferred installer”) first impression would lower the barrier to entry.

2. Package-Manager Neutrality Builds Trust

• Keeping setup instructions independent of any specific manager avoids the appearance of vendor lock-in.
• Readers can still discover uv in an “advanced installs” or “performance tips” section, without feeling pressured.

3. Tone: “Guide Me” vs. “Sell Me”

• The landing pages highlight speed comparisons (which are great!) but sometimes feel more promotional than educational.
• Adding a concise “How Ruff Fits Into Your Project” walkthrough—covering config files, CI hooks, and integration patterns—would help newcomers understand why and how to adopt Ruff, not just that they should.

---

I hope this perspective is helpful. Ruff is already an outstanding tool; a slightly softer on-boarding story could make it even more welcoming to the wider Python community.

[MichaReiser]

Thanks for your feedback.

Keeping setup instructions independent of any specific manager avoids the appearance of vendor lock-in.

I think this is somewhat hard without picking one or the documentation will feel very abstract. I know I'm biased but I think uv is a pretty good choice for users who haven't used any package manager before. Everyone else will know what their favorite package manager is and probably know how to translate our setup instructions.

However, I could see us moving the "info" block saying that you could also use pip further up.

[d0lwl0b]

But this will weaken the presence of ruff itself. 🤔

[d0lwl0b]

Thank you for your reply. ❤️