Joel Hawksley / / ←home

Conference proposal: How GitHub uses linters

This proposal was accepted for RubyConf 2021. View slides


The GitHub code base is growing at over 25% every year through contributions from over 1000 engineers, clocking in at 1.7+ million lines of Ruby. In this talk, we’ll share how we use linters to keep our codebase healthy by ensuring best practices are applied consistently, feedback loops are as short as possible, and code reviews bring the most value, all without creating too much friction.


This talk is given through a series of case studies that demonstrate how we use linters at GitHub.

I introduce the topic of linting by discussing why we use linters:

I then share examples of how we use linters at GitHub today, discussing the advantages and disadvantages of each approach:

Finally, I conclude with our takeaways for how we’re thinking about our approach to linting for the future.


Whenever I tell people what it’s like to be an engineer working on the GitHub code base, they are often amazed by just how much we use linters. It’s one of the most significant differences between the GitHub code base and any other one I’ve seen.

This talk is a “behind the curtains” look at how we approach the practice of linting in one of the largest Ruby code bases in the world. While it is a Rails codebase, our linters run in an environment without Rails present, thus making this talk more appropriate for RubyConf. I will intentionally avoid any Rails-specific content.

I’m a staff engineer at GitHub, working on ensuring our user interface is implemented in a consistent manner. My work often involves building linters that help us adhere to agreed-upon best practices.

I have a decent amount of public speaking experience- I’ve spoken at several conferences, including a couple of times at RailsConf. I’ve also appeared on a handful of Ruby-related podcasts.