Writing blog posts and strong documentation for your open source projects is crucial for growing both a user and a contributor base. Your writing is the most effective way to communicate why and how people should use your project. But you’re a software engineer, not a content strategist. How can you effectively target the people you need to with your blog posts and documentation? Also, how can you accurately communicate the goals for your project?
Alison Spittel walks you through the writing process from deciding who you’re writing for to what happens after you press publish (or commit to GitHub). You’ll learn why strong documentation and blog posts are important for open source projects and look at some projects that have great content strategies and who your target audience is—whether that’s new developers or specialized experts. Alison helps you come up with blog post topics, how to make that content engaging and understandable, and how to reach that audience and grow a following.
After the hands-on portion, you’ll leave with the following completed worksheets:
Ali Spittel is a programmer, teacher, and writer and a software engineer at DEV. You can read her writing, which had well over half a million readers last year, at dev.to/aspittel. She moonlights as a lead instructor at General Assembly. In addition to contributing to the open source DEV platform, Ali also maintains Learn Code from Us, a platform that highlights technical content creators who are members of underrepresented groups in tech. She’s also highly involved in the DC tech community where she’s the tech director for Women Who Code and is the founder of the Art + Code Collective and the Vue Vixens’ DC chapter.
Help us make this conference the best it can be for you. Have questions you'd like this speaker to address? Suggestions for issues that deserve extra attention? Feedback that you'd like to share with the speaker and other attendees?
Join the conversation here (requires login)
©2019, O'Reilly Media, Inc. • (800) 889-8969 or (707) 827-7019 • Monday-Friday 7:30am-5pm PT • All trademarks and registered trademarks appearing on oreilly.com are the property of their respective owners. • firstname.lastname@example.org