Integrated CI/CD at Atlassian

Bitbucket is Atlassian's product for storing and reviewing code. In 2020, the team shipped Integrated CI/CD, a feature that let engineers link Bitbucket with Jenkins, the platform they used to build, test, and deploy their code, so they could see build results inside Bitbucket, where they were already working.

The setup was the hard part. To link the products, an admin had to set up the link from both ends, registering Bitbucket as a user in Jenkins, then registering Jenkins as an Application Link in Bitbucket. Several values had to be copied between the two. Easy to get wrong, hard to debug.

I led the content design across the rollout. I wrote new Bitbucket UI copy. I wrote and published the Bitbucket docs, the Jenkins plugin page, and the release notes that announced the feature across multiple releases. For the steps that were hardest to follow, I also scripted, recorded, and edited three walkthrough videos for Adding instance details, Creating an Application Link, and Setting up a Multibranch Pipeline. When the user is moving between two admin UIs and copying values across, written instructions only get you so far. The videos were the part that made the steps make sense.