Atlassian adds Optic to Compass to automate API docs and governance

# What happened Atlassian bought Optic and is integrating its open-source OpenAPI tooling into Compass, Atlassian's developer experience platform. The stated aim is to give engineering teams native, automated API documentation and governance inside Compass so developers can find and use accurate docs and avoid breaking changes.

# What Optic brings Optic created tools that work with the OpenAPI specification to discover and maintain API documentation. Key capabilities described in the announcement:

• Detect and publish OpenAPI docs found in code into Compass.

• Notify API consumers in Compass when changes affect them, reducing surprise breakages.
• Enforce shared standards for design, security, and stability and report API quality on Compass scorecards.

# Why Atlassian is doing this

# Who already uses Compass The article lists several companies using Compass today, including Boden, Dropbox, KFC UK&I, and ExpressVPN. The narrative positions Optic as a way to accelerate adoption of API-first practices inside those kinds of engineering organizations.

# What changes for engineering teams Teams using Compass should expect a new path for API discovery and lifecycle management:

• Documentation discovery becomes automated: Optic will find OpenAPI files in repositories and publish them to Compass.
• CI-driven documentation updates: Changes merged through CI can automatically update the published docs and trigger consumer notifications.
• Policy and scorecard integration: API design and stability checks will contribute to the same health and standards metrics teams already use in Compass.

This reduces manual documentation upkeep and centralizes API visibility and governance within the developer platform engineers already use for service tracking and standards.

# Practically useful points for engineers and platform teams

• If your org uses OpenAPI, Optic's tooling will surface existing specs into Compass instead of requiring manual publishing.

• Use Compass scorecards to compare API quality and stability with other operational metrics, which can help prioritize remediation and standardization efforts.

# Who wrote the announcement The post is attributed to Matthew Schvimmer, Head of Product, ADO. It promotes the Optic acquisition as a way to accelerate developer productivity with Compass.

# Bottom line Optic brings automated OpenAPI discovery, CI-linked documentation updates, breaking-change notifications, and policy checks into Compass. For organizations standardizing on internal developer platforms and facing API sprawl across microservices, this integration aims to centralize API documentation and governance inside Atlassian's developer experience tooling.