A renewed focus & community changes

Alex Suraci
Mar 29, 2018 · 3 min read

Phew, we’ve been busy for the past couple of months! There’s a lot to give y’all an update on.

New website

First off, ! We’ve completely redesigned it and redone how we organize the documentation, in hopes that it’ll be much easier to find what you’re looking for.

We also hope that the new style, language, and tone will feel a bit more inclusive and humble. For example, we got rid of the “Concourse vs.” section — the effort it took to keep that up-to-date is better spent elsewhere. Use whatever dang tool you want! Our old site, as pretty as it was, felt a bit too much like we were trying to sell a finished product.

We’ve added an which provides all the background and motivation you should need to get a good idea of who we are and what we’re about. There’s also a which contains reference material for developers as well as general guidance. We’re also fleshing out an which should help out those who are deploying Concourse for the first time or managing it at scale.

In addition to these new sections, we’ve also consolidated many pages and simplified the organization. There are now top-level sections for all the “things” you’ll be working with (Pipelines, Tasks, etc.), and each section contains the schema right up-front with examples to the side. This should make the docs much more effective when used as a reference.

Search is back, and we’ve made a lot better than it was before its unceremonious removal. Try searching “imgrespar” and you’ll find image_resource.params. It’s not full-text, but there’s always Google for that. I tried but it’s pretty slow and janky

Community platform changes

Along with the new site, we’re changing a few things in an effort to foster a healthier, more collaborative community:

  • This will be a much better format for support, long-form discussion, announcing cool new resource types, and whatever else y’all want to talk about.
  • We hope to have this new chat platform be an organized place for contributors to have meaningful discussions, rather than a firehose of help requests. There’s still a #need-help channel, but we’d prefer if most support went through the forums instead, as persistent threads are much easier to keep tabs on and are much easier to find in Google search results.
  • This is thanks to a tool called , which provides visibility into each of our GitHub projects (which are normally hidden on GitHub). It also provides a networked view of issues and PRs that helps us identify the “boulders” vs. the “pebbles” when it comes to understanding problem spaces to tackle.

Simpler deployment

We’ve coordinated all this with the launch of 3.10.0, which simplifies how Concourse is deployed. We’ve made it easier to spin up a single-instance Concourse via the quickstart command, which we’re in turn using for a the quick intro on the front page, via Docker Compose. We also no longer require you to configure an external URL (which was the main obstacle in the way of a single-command intro).

Instead of documenting four different deployment methods (and scaring away people in the process), we’re focusing on the concourse binary distribution as the lingua franca on the main site. It’s the most general and assumes the least about how you want to deploy it. For platform-specific documentation, each GitHub repo will be the source of truth:

These repos are linked to by the as their own platform alongside the binaries, so they should feel just as official, while not feeling like a necessary mental hurdle for beginners.


Lastly, I want to apologize for the recent slowdown in processing pull requests. I’ve been pretty focused on getting all this out there, and it’s definitely taken away from my other duties.

I hope that with our continued focus on community building in 2018, more of these responsibilities can be shared among a broader, stronger network of contributors. If you’re interested in stepping up and helping out in a meaningful way, let us know early and we can help! That’s part of the reason for introducing Discord and the forums.

We’re still figuring things out, and hope to provide more structure to the contribution process for those who need it, but a conversation is a great start.

As always, thanks everyone for your patience and support.


Concourse CI

The Continuous Thing Do-er

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch

Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore

Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store