Skip to main content

Jekyll: Where content is truly king

2 min read

Summary: 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 and 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.

Keep reading

Ben Balter

I'm Ben Balter, and I write here about developer platforms, product and engineering leadership, open source, and showing your work. I spent a decade building developer platforms at GitHub: five years as a product manager for trust and safety, shipping 500+ features and the API endpoints behind them to 50M+ developers, plus a bottom-up rewrite of GitHub Pages and the open source library behind GitHub's license detection. My open source projects have hundreds of millions of downloads. I wrote Open and Async, the playbook for remote and distributed teams, and shipped an MCP server alongside it so agents can query it directly. At GitHub I was also Director of Hubber (Employee) Enablement, owning the internal platform 4,000+ GitHubbers use to get their work done, Chief of Staff for Security, and the company'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

Originally published October 30, 2013 View revision history

This page is open source Help improve this article on GitHub

Keyboard shortcuts

Search

  • / or ⌘ K Open search
  • ↓ or j ↑ or k Move through results
  • Enter Open the selected result
  • Esc Close search

Go to

  • g then h Home
  • g then p All posts

This page

  • y Copy link to this page
  • ? Show this list