Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Atlantis 1.0.0 blog post #5296

Draft
wants to merge 5 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions runatlantis.io/.vitepress/sidebars.ts
Original file line number Diff line number Diff line change
Expand Up @@ -101,6 +101,16 @@ const en = [
link: "/blog",
collapsed: false,
items: [
{
text: "2025",
collapsed: true,
items: [
{
text: "Introducing Atlantis 1.0.0!",
link: "/blog/2025/introducing-atlantis-1-0-0"
},
]
},
{
text: "2024",
collapsed: true,
Expand Down
32 changes: 32 additions & 0 deletions runatlantis.io/blog/2025/introducing-atlantis-1-0-0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
title: Introducing Atlantis 1.0.0!
lang: en-US
---

# Atlantis 1.0.0

The core team is excited to announce the release of Atlantis 1.0.0! This release is many years in the making, and we're excited to be bringing Atlantis into this next chapter.

## Questions

### Why now?

Atlantis has reached level of maturity, both as a product as well as a project, that justifies the designation that comes with a stable 1.0.0 release.

One technical issue that this release solves is that, right now, when the Atlantis team publishes a new feature release by incrementing from `0.X.Y` to `0.{X+1}.0`, it is impossible to tell if there are breaking changes in the release without reading the release notes. In a post-1.0.0 world, breaking changes will always be accompanied by a bump in the major version (see below), hence the version number will encode more meaning.

### What should we expect from this release?

We don't expect 1.0.0 to be any different than any of our "minor" releases starting with `0`. It is primarily an indication that we believe the product is stable enough to warrant 1.0.0 release, and to show our commitment to both stability and backwards compatibility.

### Will there be do an Atlantis 2.0.0?

There are no immediate plans to release Atlantis 2.0.0, nor do we think it will never happen. We are roughly following semver guidelines described [here](https://semver.org/), which note that the major version should be incremented if "backward incompatible changes are introduced to the public API". (TODO: What does that mean for Atlantis?). If that ever happens, we reserve the right to release Atlantis 2.0.0.

### How will we decide whether to increment major, minor, or patch for a given release?

We are roughly guided by the recommendations [here](https://semver.org/), which roughly say that bug fixes go in patch releases, feature changes go in minor releases, and backwards incompatible changes go in major releases.

As mentioned above, right now backwards incompatible changes are included together with "normal" releases. As we get experience separating these, we will develop a more clear understanding of what it means for a change to be backwards incompatible. For now here are a few guidelines:
- Changes to server or repo config such that previously specified valid flag and configuration immediately fail
- Changes to behavior like when applies and plans are run, except when gated by a new flag or setting