⚠️⚠️ DEPRECATED ⚠️⚠️

Please go to the Engineering wiki in Notion.

Buffer Engineering Wiki

Welcome, friend! 👋 This is the Buffer Engineering Wiki. It's is a living, evolving project that exists to guide you through all the info you need to know to be a happy and productive Buffer Engineer™.

It's a handy reference whether you're new, changing teams, or just like breaking down knowledge silos. 💥

Table of Contents

💁 In no particular order, please keep up to date and feel free to rearrange in your PRs

Local Development

Get all setup to work on Buffer locally

• :octocat: buffer-dev

Team Specific

• Data Team
• Account Management
• Publish
• Mobile
• Systems

Seeking Advice & Input

• How the Architecture Review process works

Engineering Leadership

• How Engineering Management Works at Buffer
• (All-Buffer)Code of Conduct

Buffer Web

The web app at buffer.com/app, API, static pages, and more!

• :octocat: buffer-web
• Deployments
• Deployments for buffer-web
• PHP Guidelines — Great doc by @josem on writing PHP in buffer-web
• PHP Testing
• Feature Flips
• ️buffer-web workers in k8s
• ️Lifecycle of an update
• Editing files and making a PR directly on GitHub

Buffer Marketing

The home page at buffer.com, more static pages, salary calculator, and more!

• :octocat: buffer-marketing
• Check out the README in buffer-marketing for some great documentation.

Blog

Our blogs, hosted on WPEngine.

• Wordpress Blogs

Billing

Everything related to the Stripe API & Webhook and our billing logic.

• Billing API endpoint signatures

Open Source

Everything related to Open Source at Buffer

• Buffer Open Source FAQ

Meta

• Contributing to the Wiki
• Encryption Tool for this Wiki

Contributing to the Wiki

All contributions would be glorious. An out of date wiki is so much worse than the occasional misleading new contribution, so please err on the side of sharing your knowledge.

Wikis are best when they're living and evolving. As an async, remote team, let's create a wiki that reflects our commitment to this way of work! 🌍

👉 Read how to contribute right here!

tl:dr;

1. Be the change you want to see on the wiki ✨ Just edit it directly on Github ✏️
2. Got more of a suggestion than an immediate change? Open a Pull Request 🙋🏽‍
3. Not sure what the right info is, but you can see the current docs are wrong? Open an issue 🤔
4. Got lots to share? Awesome!🦄 Work on this wiki locally: $ git clone git@github.com:bufferapp/README.git