Getting GitHub: Why journalists should know and use the social coding site

The famous GitHub logo.

If you've been hanging around newsrooms or journalism classrooms lately, you've probably heard the word GitHub. It might sound a little scary and mysterious, but even the most traditional pen-and-notebook journalists should know about this super helpful tool (to say nothing of aspiring newsroom programmers).

So, what, exactly, is GitHub? Why do you need to get it?

GitHub is a social coding site. Designed for the purpose of democratic and collaborative coding, GitHub allows multiple people to work on the same code at the same time.

You can host your own code (called a repository), fork others' code and suggest changes (more on that below), and accept changes and merges into your own code.

Have you ever seen Octocat (GitHub's unique cat/octopus mascot) badge on someone's portfolio? That's GitHub. Clicking on that will lead you to someone's GitHub profile, where you can explore all of their publicly hosted code and as well as other projects they've played around with.

But beginners should take note: GitHub isn't Git. And knowing the difference is crucial to developing a more productive workflow. Git is revision control software, originally developed by the Linux community. GitHub is a web-based hosting service that takes Git's software and pairs it with an easy-to-use interface that requires almost no previous coding experience to use.

Get familiar with code

GitHub is an ideal platform for beginning coders because the site is easy to use and version control can act as a safety net as you try new new things. And if you can't quite figure out where you've gone wrong, the site provides users with plenty of avenues for easy troubleshooting on new projects.

David Eads of the Chicago Tribune Newsapps team says you can think of GitHub like a filing cabinet. After a project is published, it's easy for others to go back and examine the code, learn from it and make it better. Moreover, GitHub's Gist feature is a quick way to jot down bits of code you want to remember or show to someone for another opinion.

And don't forget, GitHub is called a social network for a reason. Newcomers can watch code as projects take shape or troubleshoot with more experienced users. Groups like OpenHatch aim to answer coding questions and maintain a set of projects on GitHub that are helpful for beginning programmers.

Beyond GitHub's operational utility, it serves as yet another way journalists and programmers can work together and create innovative projects.

"In a lot of cases, journalists and programmers need to figure out how to hang out in each other's worlds better," Eads said. As more journalists embrace GitHub as a way to improve stories, they'll develop a new kind of news community, centered around collaboration and code – truly a news nerd's nirvana.

Some vocab

Before diving into GitHub, get a leg up by understanding its litany of technical terms. You'll also want to download Git and the GitHub native app for either Mac or Windows. GitHub explains every step on their website.

  • Commits — This is simply a change you make to a piece of code, or a set of related changes made on multiple files.
  • Forking — Forking is simply the copying of an existing code repository at a specific point so you can add to it as you see fit. The original code still exists for the creator, but your fork may spin off into a lively new project. This means that any project publicly hosted in GitHub can be edited by anyone. For example, if you find a typo in the ProPub Nerd Guide you can change it.
  • Pull requests — Pull requests let users know what changes you may have pushed to a particular repository. Once you send a pull request, other users can review your changes and incorporate them into their repositories.


Journalism projects and resources to get you started

Getting on GitHub will open a world of new projects and applications you can repurpose for your own reporting. "Anything cool you can find on the internet you can probably also find on GitHub," said Zach Wise, a faculty collaborator at the Lab. Adds Knight Lab student fellow Tyler Fisher added, "If an open-source project isn't on GitHub, there's a bit of a concern at this point."

To get started look at these projects and resources for the burgeoning code curious journalist. Several news apps team filled with coding all-stars have compiled guides that define their particular style and manifesto when it comes to creating interactive projects. There are also a bevy of cool projects that can help you trick out your slideshow style, build a better website or flesh out your coding skills.


So go on, get GitHub and get started.

About the author

Emily Ferber

Undergraduate Fellow

Latest Posts

  • Introducing StorylineJS

    Today we're excited to release a new tool for storytellers.

    StorylineJS makes it easy to tell the story behind a dataset, without the need for programming or data visualization expertise. Just upload your data to Google Sheets, add two columns, and fill in the story on the rows you want to highlight. Set a few configuration options and you have an annotated chart, ready to embed on your website. (And did we mention, it looks great on phones?) As with all of our tools, simplicity...

    Continue Reading

  • Join us in October: NU hosts the Computation + Journalism 2017 symposium

    An exciting lineup of researchers, technologists and journalists will convene in October for Computation + Journalism Symposium 2017 at Northwestern University. Register now and book your hotel rooms for the event, which will take place on Friday, Oct. 13, and Saturday, Oct. 14 in Evanston, IL. Hotel room blocks near campus are filling up fast! Speakers will include: Ashwin Ram, who heads research and development for Amazon’s Alexa artificial intelligence (AI) agent, which powers the...

    Continue Reading

  • Bringing Historical Data to Census Reporter

    A Visualization and Research Review

    An Introduction Since Census Reporter’s launch in 2014, one of our most requested features has been the option to see historic census data. Journalists of all backgrounds have asked for a simplified way to get the long-term values they need from Census Reporter, whether it’s through our data section or directly from individual profile pages. Over the past few months I’ve been working to make that a reality. With invaluable feedback from many of you,......

    Continue Reading

  • How We Brought A Chatbot To Life

    Best Practice Guide

    A chatbot creates a unique user experience with many benefits. It gives the audience an opportunity to ask questions and get to know more about your organization. It allows you to collect valuable information from the audience. It can increase interaction time on your site. Bot prototype In the spring of 2017, our Knight Lab team examined the conversational user interface of Public Good Software’s chatbot, which is a chat-widget embedded within media partner sites.......

    Continue Reading

  • Stitching 360° Video

    For the time-being, footage filmed on most 360° cameras cannot be directly edited and uploaded for viewing immediately after capture. Different cameras have different methods of outputting footage, but usually each camera lens corresponds to a separate video file. These video files must be combined using “video stitching” software on a computer or phone before the video becomes one connected, viewable video. Garmin and other companies have recently demonstrated interest in creating cameras that stitch......

    Continue Reading

  • Publishing your 360° content

    Publishing can be confusing for aspiring 360° video storytellers. The lack of public information on platform viewership makes it nearly impossible to know where you can best reach your intended viewers, or even how much time and effort to devote to the creation of VR content. Numbers are hard to come by, but were more available in the beginning of 2016. At the time, most viewers encountered 360° video on Facebook. In February 2016, Facebook......

    Continue Reading

Storytelling Tools

We build easy-to-use tools that can help you tell better stories.

View More