(opening a new thread to not distract from the effort in https://discourse.julialang.org/t/coordinating-community-efforts-to-enrich-function-docs/ ) Looking over the recent discussion about improving docs, it’s clear that people find issues they could fix with the docs but don’t necessarily open iss…

For me personally git panic? Yes, knowing a little git and had an account but still felt insecure about doing something wrong and had never really used it for PRs/issues but mostly for storing personal projects. After the first few PRs this mostly disappeared. I don’t think this was ever any conce…

the huge number of open issues and prs on the git repo that’s putting people off contributing because they assume their contribution will just be ignored? That’s not been my experience, but some contributions certainly fall through the cracks I have actually experienced this at times, where feedb…

Try to say something about that a while ago but it has not been found relevant Non-friendly documentation - #22 by LaurentPlagne

[image] antoine-levitt: making a PR with a large number of pre-filtered small changes (which is easier for people in the main repo to review and merge) My experience with code reviews in general, not specific to Julia, is that multiple independent small PRs are easier to review than one large…

imho: 1.) Not much encouragement in the basic documentation. just search for “contributing” https://docs.julialang.org/en/v1.9-dev/search/?q=contributing Probably we need to add simple Contributing information for the “Getting Started” part. or we can extend the “Documentation” part with “Fixi…

It may also be interesting to highlight issues where contributions should be easy, for instance by adding a link to the filtered list of “good first issues”

I think that is good if someone has passed the “git fear”, but I would already be happy if someone noticing a mistake in the docs or seeing some improvement first even opens an issue. To the general topic, after a few PRs that grew really large, I am also becoming more and more a fan of small PRs, …

All points mentioned above are valid, I may add less-than-perfect English. My own experience with the only documentation PR I have tried (on an not especially important point) was that I got a pretty unfriendly reply - I hope that was an exception, but that was it for me. In any case, the threshold …

@jishnub you should bump that more frequently. reviewers often go through cycles of ignoring emails for a while then getting back to them, so you have to get them when they are paying attention to that particular area

Lowering the bar for beginner contributions

Community

fredrikekre May 2, 2022, 9:49am 9

For reference: Non-friendly documentation. In particular Tim took action and made a 2 min video on how to contribute easily!

2 Likes

Topic		Replies	Views
Documentation PR learning curve still too steep Community documenter , github	9	1124	June 7, 2024
Identifying barriers to new contributions to Julia and its ecosystem Community github , contributing	14	1091	January 5, 2025
Making the review process more pleasant for new contributors General Usage github , contributing	59	4226	July 18, 2024
Non-friendly documentation New to Julia question , documentation	137	9381	September 18, 2020
Suggestion to slightly improve Julia development Community	94	5765	May 31, 2021

Lowering the bar for beginner contributions

Related topics