search

astropy / astropy-workshop

Materials for Astropy Workshops
BSD 3-Clause "New" or "Revised" License
102 stars 67 forks source link

Workshop in ADASS #236

Open pllim opened 6 months ago

pllim commented 6 months ago

We have done quite a few in AAS but those are introductory and aimed at users. According to https://astropy-report.orgmycology.com/sections/community_recommendations#workshops , there might be a need for workshop that targets new potential contributors in ADASS.

I think we could hold contributor workshops or Github workshops at more technical meetings like ADASS.

jduckles commented 6 months ago

A couple of related things:

Deconstructed workshops - I wonder if some of these GitHub contributor workshops could be "deconstructed" and taken online. Maybe 4 1-hour sessions over four weeks, would be equivalent to a half-day workshop. With a recording and some "exercises" making commits to a "learning" repository could be helpful to let the workshop have legs for a few months afterwards as well.

Supporting First PRs - If community members haven't done PRs before, I have taught the GitHub pull request model to those who haven't experinced it with a "demo" repository. It contanis content that most people can find something to commit to it (trivia about all the countries in the world). This can demystify the process of a pull request for those who have never gone through that process before. I'm not sure if this level of support is a need or not in this community though.

Contribute to Documentation First - To learn the contributor "ways of Astropy" perhaps we can find ways to encourage their first-commit target to be improving documentation, before committing software PRs to the core packages. Small documentation PRs are likely needed, and helpful, and demystify the mechanisms of contribution for people who are keen to find ways to contribute. A culture of documentation improement can be kicked off with a bug BBQ event as well.