Lowering the bar for beginner contributions

OK, the help for new contributors is split between Contribution Pathways (which is linked to in the bottom of the home page, not very visible; generally speaking, the structure of the webpage is pretty weird, with both a menu on the top and one on the the bottom) and julia/CONTRIBUTING.md at master · JuliaLang/julia · GitHub. CONTRIBUTING.md is linked to from the homepage, but the link is hidden (it’s the only non-bold thing in a sea of bold). Both documents are pretty technical, the two don’t reference each other, they are pretty long, they mostly address code PRs, and don’t address github workflow issues and etiquette (for instance @jameson 's suggestion of pinging back at reasonable intervals). There could be a short “we welcome contributions, both code and docs, both issues and PRs, PRs are easier than it sounds, don’t worry about breaking stuff, here’s how to make a PR with github’s simplified interface if you don’t know git, here’s how to make a PR with the full github workflow if you do, feel free to ping back every couple of weeks if there is not reply, here’s where to ask for help, here’s more extensive info (link to CONTRIBUTING.md)”, but I’m not quite sure where to put it, and whether/how to change the existing info (to avoid the xkcd: Standards syndrome)

6 Likes