Articles tagged: documentation

1. 

   SRCCON Spotlight: Building a Culture of Documentation

   By Erin Kissane, Lauren Rabaino, and Kelsey Scherer

   Posted on July 25, 2017

   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.

2. 

   What I Learned from Researching Newsroom On-boarding and Off-Boarding Processes

   By Sandhya Kambhampati

   Posted on December 15, 2016

   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.

3. 

   Building a Guide to Open-Sourcing Newsroom Code, Together

   By Lindsay Muscato

   Posted on December 8, 2016

   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.

4. 

   Field Notes from SRCCON 2016

   By Katie Jansen, Ebony Martin, and Zara Stone

   Posted on August 25, 2016

   Three SRCCON participants share notes and learnings from this year’s conference in Portland.

5. 

   Hello from SRCCON 2016

   By

   Posted on July 28, 2016

   Source is in Portland this week for SRCCON 2016. Here’s how you can follow along with us.

6. 

   Writing the Patch for Communication Gaps

   By Michael Grant

   Posted on September 22, 2015

   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.

7. 

   How to Run Projects on Time—and Keep Your Sanity

   By Lauren Rabaino

   Posted on September 15, 2015

   Vox’s director of editorial products on how to set up the processes you need to run healthy projects and a jubilant team.

8. 

   Better Documentation Is Within Reach

   By Noah Veltman

   Posted on August 26, 2015

   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.

9. ProPublica’s News Apps Guides

   By Scott Klein

   Posted on February 28, 2013

   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.