![\"Title](\"http:\/\/redmonk.com\/kfitzpatrick\/files\/2023\/01\/DAI-Making-OSS-Sticky-Thumbnail-1024x580.jpg\")
<\/p>\n<\/p>\n
In this The Docs Are In conversation<\/a>, Kate<\/a> and I chat with documentarian Alyssa Rock<\/a> about fostering \u201cstickiness\u201d in open source software (OSS) projects and related communities. The stickiness of a community, as Alyssa defines it, \u201cis about making it so that people want to stay and stick around and make a long term contribution.\u201d Stickiness can be tricky for OSS communities, as many contributors and maintainers participate on a volunteer basis and for a variety of motivations.<\/p>\n Alyssa is herself in a position where her day job–she is a Staff Technical Writer at VMware–includes working on the Salt project<\/a>, a Python-based configuration tool. Alyssa landed at VMware through its 2020 acquisition<\/a> of SaltStack, a company built around the open source Salt project. In addition to working directly on Salt documentation<\/a>, she runs the Salt docs working group. Alyssa is also very active in other projects and communities. She is the Community Manager of The Good Docs Project<\/a> (which creates processes and templates designed to make it easier for non-professional documentarians to create great documentation) and Coordinator for the Write the Docs Quorum Program<\/a>. Alyssa therefore has spent a lot of time thinking about (and executing on) ways to onboard folks onto projects, and the role documentation plays in this process.<\/p>\n While documentation per se is often essential to a project and its community, it is also a part of the project that needs to recruit and retain contributors. Alyssa walks through some of the processes she employs specifically to make the documentation components of the projects she works on sticky:<\/p>\n So I\u2019m always working on building out a backlog of documentation epics and a roadmap of what I would do if I had more resources. And because I have that backlog of things that I would do if suddenly I got a lot more people working for me, when somebody does join, I have something for them to look at. I can say, look at the backlog, look at this roadmap, see if there\u2019s any of these projects that interest you, or sometimes I\u2019ll just have an in-depth interview with them and talk about \u201cWhat are your goals for contributing? What are you hoping to get out of your time here with us at the project?\u201d And I\u2019ll see if I can find a task that matches your needs and what you\u2019re hoping to get out of it, which increases the chance that they\u2019ll stick around because it has some intrinsic value to them.<\/p><\/blockquote>\n My sense is that this type of personalized onboarding requires a lot of care and skill on the part of folks like Alyssa, but has the potential for huge rewards in terms of retaining interest (and, to keep the sticky metaphor going, is glue work at its finest). And, as Alyssa points out, one of the key factors is fostering a mutually supportive environment:<\/p>\n What makes the project sticky, I think, is that we\u2019re all supporting each other in our professional goals. We\u2019re all trying to be better. We\u2019re trying to be better writers or better developers or whatever it is we\u2019re trying to skill up with, and we\u2019re all in this together supporting each other.<\/p><\/blockquote>\n Indeed, one of my favorite parts of the conversation is when Alyssa talks about how contributors to her projects have managed to leverage that experience (often bolstered by the fact that they are using relevant tools to work on recognized projects) in order to obtain jobs in the tech industry.<\/p>\n Check out the video below for the full conversation (including Alyssa\u2019s background in Film Studies and sojourn into higher education) or see the full transcript and related links<\/a>.<\/p>\n