Projects walkthroughs, tool teardowns, interviews, and more.
Articles tagged: documentation
SRCCON Spotlight: Building a Culture of Documentation
By Erin Kissane, Lauren Rabaino, and Kelsey SchererPosted on
Last year’s SRCCON participants got a lot out of Lauren Rabaino & Kelsey Scherer’s docs session, and we’ve found ourselves returning to the transcript more than once.
What I Learned from Researching Newsroom On-boarding and Off-Boarding ProcessesPosted on
As a Knight-Mozilla fellow, I wanted to do some type of research during my fellowship that could benefit the news community. During my 10-month fellowship in Berlin in 2016, I spent about eight months researching, collecting data and interviewing reporters, editors, managers, and directors about their on-boarding and off-boarding processes.
Building a Guide to Open-Sourcing Newsroom Code, TogetherPosted on
This week, eleven contributors gathered with us in Washington, D.C. to work on a new resource—a playbook for open-sourcing newsroom code. Together we hoped to tackle a question that’s come up again and again: how to help more newsrooms produce open-source projects, so that everyone can spend more time on great journalism instead of re-creating common tools, tech, and datasets from scratch.
Field Notes from SRCCON 2016
By Katie Jansen, Ebony Martin, and Zara StonePosted on
Three SRCCON participants share notes and learnings from this year’s conference in Portland.
Hello from SRCCON 2016
Source is in Portland this week for SRCCON 2016. Here’s how you can follow along with us.
Writing the Patch for Communication GapsPosted on
Don’t let a debrief go to waste. The SF Chronicle’s Michael Grant explains how to dig deeper, solve longstanding communication problems, and support the development and implementation of new ideas.
How to Run Projects on Time—and Keep Your SanityPosted on
Vox’s director of editorial products on how to set up the processes you need to run healthy projects and a jubilant team.
Better Documentation Is Within Reach
By Noah VeltmanPosted on
Good docs help people use your work, but they have other benefits too. They encourage community contributions. They save you from your past self when you’re revisiting your own code six months from now. And they help you think: much like talking to a rubber duck helps you find bugs, carefully documenting your work for users helps you see it from a different perspective and design better code.
ProPublica’s News Apps Guides
By Scott KleinPosted on
Yesterday morning, the ProPublica apps team released a series of documents outlining their coding philosophy, app design and development practices, data validation techniques, and more. We spoke with Scott Klein about how his team’s processes evolved and how they made the time to document it all.