Quick note to say we're looking at this thread and seeing how we can support this at Preset. We'd love to help enable this, especially as we're looking to hire someone to work on documentation / tutorials / howtos / FAQ.
Also somewhat related to helping onboard contributors: I was inspired by Holden Karau's series of videos around contributing to Airflow a while back. https://www.youtube.com/watch?v=6smd-x3CbCQ I love the candid approach, leveraging her experience contributing to other open source projects and showing a path forward for others. To me it showed how hard it is even for senior engineers with open source experience and ambition to start contributing to a project like Airflow. We've been talking about improving / rewriting much of our CONTRIBUTING.md to and make it easier to setup a docker-backed dev environment. Also related - I used to label some issues with "starter-task" label as good onramping tasks (small features or bug fixes), but haven't been doing this in a while. We should start doing this again! Max On Mon, Apr 20, 2020 at 8:19 AM Erik Ritter <erik.t.rit...@gmail.com> wrote: > Hi Gaurav, > > Thanks for the thorough email with the great ideas for improving Superset! > To address your two main points: > > The Google Season of Docs seems like a very worthwhile initiative to > participate in, but I wonder if we can support it sufficiently within the > Superset organization. I see that we require 2 organization administrators > and at least 2 open source mentors for the documentation writers to > participate in the program. While I suspect many people would be interested > in helping out as mentors, it's unclear what the workload required is for > the organization administrator role within the program. > > Additionally, since the deadline for registration is May 4th, it might not > be possible to put together an application within this time frame. While > I'm not counting out the ability for us to participate, I'd expect that > we'd need at least 2 Commiters/PPMC members willing to own this project. I > would be happy to be one of them in a supporting role, but I think we need > someone else willing to step up and drive the application process as I'm > quite busy already this quarter. If anyone else wanted to volunteer then we > could continue this conversation in a Slack channel to try and nail down > details if we think it's worthwhile to apply. > > As for improving the curve for newcomers/students, I'm all in favor for the > standard of tagging beginner issues as "good first issue". I believe we > have a bot that we can use so that anyone can add tags to issues if they > feel they're good first issues (is this correct Max?), and I'd also like to > autogenerate some issues for TypeScript conversion that would be good first > issues as well. In general, providing a good entry point for new > contributors is important to maintaining and growing the Superset > community, and I think most of us would be in favor of making it easier for > new contributors to participate. > > Thanks again for your email and your ideas! > Erik Ritter > > On Sat, Apr 18, 2020 at 10:07 AM Gaurav Agrawal < > agrawalgaurav1...@gmail.com> > wrote: > > > Hi Everyone, > > > > I am Gaurav Agrawal, a student who often likes to work on superset and > > engage with the community. > > > > I am aware that superset has recently been appreciated for improving the > > docs, but I feel for further improvements and project's outreach with > > students around the world it could be really nice for it to participate > in > > Google Season of Docs. > > > > It's deadline for Organizations is very near, around 4th May is the last > > date. > > > > > > As It comes under Apache so I am not completely sure about project's > > policies and procedures for the same. > > > > > > The second thing is about improving the curve for newcomers and students, > > one such great trick for doing such thing is Newcomer issues, this is a > > very popular and established way which many open source projects adopt. > > They leave many issues explicitly which are not so urgent and are > newcomer > > friendly for students and newcomers by labelling them as "newcomers" or > > "good first issue" . > > > > In some cases developers even leave comments that can make solving the > > issue really easy. > > > > > > If this is a feasible option for Superset I would really like to see this > > happening so that we can have more and more people getting comfortable > and > > started with it. I feel that for any open source project newcomers are a > > great and for students/newcomers themselves Open source is a great way > to > > learning a lot of things like coding, community engagement, distributed > > development workflow etc. > > > > > > Thanks for your time and consideration, hope that these ideas will be > > considered. > > > > > > Best Regards, > > Gaurav > > >
