web_docs/docs/development/release-history.md

metadata

sidebar_label: release history
title: Release History
description: >-
  Project-wide release log for Open Navigator, with each version tied to a
  Postgres backup.

Release History

Project-wide release log for Open Navigator. The format is based on Keep a Changelog and the project adheres to Semantic Versioning (MAJOR.MINOR.PATCH).

Each tagged release is paired with a Postgres backup of the warehouse (open_navigator + openstates) so the code at a tag can be reproduced against the exact data it shipped with. See Releases & Data Versioning in the Quick Start guide for the make backup / make restore workflow.

This is the project-level release log. For the jurisdiction-discovery component history see its changelog.

Bump	Meaning
MAJOR	Breaking API/schema change, dropped table or endpoint, incompatible dbt
MINOR	New data source, endpoint, or dbt mart — backward compatible
PATCH	Bug fix, data backfill, or docs — no schema or contract change

Unreleased

Added

• Semantic-versioning + data-backup workflow: make backup / make restore targets and the Releases & Data Versioning section of the Quick Start guide. Each release tag is paired with version-stamped pg_dump snapshots (<db>_<version>_<date>_<sha>.dump) written to a Google Drive for Desktop folder via a WSL symlink (open-navigator-backups → H:\My Drive\open-navigator-backups), which Drive syncs off-machine automatically.

1.0.0

Initial baseline version (as recorded in web_app/package.json). Establishes the FastAPI backend, dbt medallion warehouse, React app, and Docusaurus docs.

Backup: to be provisioned — the first versioned warehouse snapshot will be written once the Google Drive for Desktop folder + WSL symlink are set up (see the Quick Start one-time setup) and H: is mounted in WSL.