Skip to main content

Jekyll: Where content is truly king

2 min read
: By choosing Jekyll over a traditional CMS for government.github.com, technology became a given, freeing us to spend six months iterating on what actually mattered — the content.

GitHub recently launched government.github.com, a site dedicated to showcasing the efforts of public servants and civic hackers which, despite its technical simplicity, was more than six months in the making, a relative snail’s pace by any startup’s standards. By choosing a static architecture over a more complex one, technology became a given, and rather than iterating on challenges to sharing information, we were able to iterate on improving the content itself, which in the end fundamentally shifted the site’s focus and overall user experience.

Initial commit of government.github.com, versus today

Had we chosen to go the traditional WordPress, Rails, or really, any other route, we would have been distracted by and had been forced to dedicate a significant portion of our time to just getting things to work. Are the permissions right for this post? Is the SEO plugin working properly? Will it scale as expected on launch day? That’s all just technical noise, noise not even remotely necessary in many cases.

Instead, Jekyll, the static site generator baked directly into GitHub Pages, introduced a level of zen-like simplicity, that allowed us to focus on one thing and one thing only: content. Are we solving for the right thing here? Can we word this better? Is this line absolutely necessary? We knew it was going to work, so we were able to move on to more important things.

But there was another major advantage. By treating the content as code, we suddenly empowered ourselves to use a more evolved editorial workflow. Forks, pull requests, a running list of issues… the content truly was an open source project in itself, and as we close in on nearly 100 contributors, the content is only getting better each day.

Open source is about tackling shared challenges together; there’s no reason the philosophy need be limited to just code, and with dumb-simple tools like Jekyll which not only empower such workflows, but also free you up to focus on what matters, there’s no excuse for content not being king.

Originally published October 30, 2013 View revision history
Share

More to explore

Welcome to the Post-CMS World

7 min read

Jekyll (and other static-sites) lead to simple, flexible, and reliable websites that allow for a renewed focus on what actually matters: the content.

Helpful 404s for Jekyll (and GitHub Pages)

3 min read

How to build 404 pages for Jekyll and GitHub Pages that automatically suggest similar URLs to those requested, using Levenshtein distance and your sitemap.

We've been trained to make paper

5 min read

If the internet is the primary medium by which content is consumed, shouldn't that be the primary medium for which content is prepared?

Ben Balter

I'm Ben Balter — I write here about engineering leadership, open source, and showing your work. By day I'm Director of Hubber Enablement at GitHub, where I help thousands of GitHubbers do their best remote work. Before this role: Chief of Staff for Security, enterprise PM, and GitHub's first Government Evangelist. Before GitHub: attorney, Presidential Innovation Fellow, and member of the White House's first agile development team. More about the author →

Follow along: Bluesky LinkedIn

This page is open source Help improve this article on GitHub