Opened 3 hours ago
#37146 new Cleanup/optimization
New Contributor Instructions Mildly Discouraging
| Reported by: | Margaret Fero, CodePath Instructor | Owned by: | |
|---|---|---|---|
| Component: | Documentation | Version: | 6.0 |
| Severity: | Normal | Keywords: | |
| Cc: | Triage Stage: | Unreviewed | |
| Has patch: | no | Needs documentation: | no |
| Needs tests: | no | Patch needs improvement: | no |
| Easy pickings: | yes | UI/UX: | no |
Description
One of the first things I saw in the Readme was the instruction "Docs are updated rigorously. If you find any problems in the docs, or think they should be clarified in any way, please take 30 seconds to fill out a ticket here: https://code.djangoproject.com/newticket". I clicked it just to see what was on the page.
However, coming in as a new person, that page displays a giant "Error: Forbidden" with two different warning banners on it, which would likely be discouraging if I weren't already an experienced contributor to other projects.
Adding that you can log in with GitHub (where you're being sent from) and that you must log in somehow would alleviate the "oh no, the page is yelling at me" feeling there. Feel free to assign to @MaggieFero (my primary account) if you'd like me to add such a mention.
Screenshot of the Forbidden error with warning banners