From 6ca4c468c441091b7566459a46394cd646c2c94d Mon Sep 17 00:00:00 2001 From: zchpeter Date: Fri, 27 Feb 2026 03:11:24 -0500 Subject: [PATCH 01/11] Add GitOps workflow SVG diagram for overview page MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Figma-style flowchart showing the 3-phase GitOps workflow: Develop (write SQL) → CI (PR triggers SQL review) → CD (merge triggers rollout to databases). Co-Authored-By: Claude Opus 4.6 --- docs/content/docs/gitops/gitops-workflow.svg | 127 +++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 docs/content/docs/gitops/gitops-workflow.svg diff --git a/docs/content/docs/gitops/gitops-workflow.svg b/docs/content/docs/gitops/gitops-workflow.svg new file mode 100644 index 000000000..102dd0773 --- /dev/null +++ b/docs/content/docs/gitops/gitops-workflow.svg @@ -0,0 +1,127 @@ + + + + + + + + + + + + + + GIT + Write migration or schema files + Push SQL changes to a feature branch in your Git repository + + + + + + + + + + + + + CI PHASE + + + + + + + + + GIT + Create Pull Request + Open PR/MR with SQL changes + + + + + + triggers + + + + + + BYTEBASE + SQL Review + Check syntax, lint, and enforce policy + + + + + + + + + + Review results posted as PR comments — blocks merge if critical issues found + + + + + + + + + PR MERGED + + + + + + + + CD PHASE + + + + + + + + + GIT + Merge to branch + Webhook notifies Bytebase + + + + + + triggers + + + + + + BYTEBASE + Create Rollout + Plan and stage changes + + + + + + + + + + + BYTEBASE + Apply to Databases + dev → staging → prod + + From fd3ec7859123d798cbb2f961022a0d5c173a12cd Mon Sep 17 00:00:00 2001 From: zchpeter Date: Fri, 27 Feb 2026 03:25:29 -0500 Subject: [PATCH 02/11] Redesign GitOps workflow diagram to left-to-right layout MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Main flow is now horizontal: Develop → CI → CD - Each phase shows Git on top, Bytebase below, Databases at bottom - Transition pills: "PR/MR created" and "PR/MR merged" - Database section shows Dev/Staging/Prod as individual instances - Wider spacing between columns for clear transition labels Co-Authored-By: Claude Opus 4.6 --- docs/content/docs/gitops/gitops-workflow.svg | 246 +++++++++++-------- 1 file changed, 138 insertions(+), 108 deletions(-) diff --git a/docs/content/docs/gitops/gitops-workflow.svg b/docs/content/docs/gitops/gitops-workflow.svg index 102dd0773..b56dc9bc2 100644 --- a/docs/content/docs/gitops/gitops-workflow.svg +++ b/docs/content/docs/gitops/gitops-workflow.svg @@ -1,127 +1,157 @@ - + - - - - - - - - - - GIT - Write migration or schema files - Push SQL changes to a feature branch in your Git repository + + + + + + + DEVELOP + + + + + GIT + Write SQL files + migration or schema + + + + + + + + + + PR/MR created + + + + + + CI + + + + + + + + GIT + Create Pull Request + Open PR/MR with SQL changes - - - - - - - - - - CI PHASE - - - - - - - - - GIT - Create Pull Request - Open PR/MR with SQL changes + + + triggers + + + + + + BYTEBASE + SQL Review + Check syntax, lint, enforce policy - - - - triggers - - - - - - BYTEBASE - SQL Review - Check syntax, lint, and enforce policy + + + + + + + + Results posted to PR + Blocks merge if issues found - - - + + + - - - - Review results posted as PR comments — blocks merge if critical issues found - + + + + PR/MR merged - - - - - - - PR MERGED - - - - - - - - CD PHASE - - - - - - - - - GIT - Merge to branch - Webhook notifies Bytebase + + + + + CD + + + + + + + + GIT + Merge to branch + Webhook notifies Bytebase - - - - triggers - - - - - - BYTEBASE - Create Rollout - Plan and stage changes + + + + triggers + + + + + + BYTEBASE + Create Rollout + Plan and stage changes - - - - - - - - - BYTEBASE - Apply to Databases - dev → staging → prod + + + + apply + + + + + DATABASES + + + + + + + + Dev + + + + + + + + + Staging + + + + + + + + + Prod + From e8cade5cd9a0720b398e041b978d3e23908193e9 Mon Sep 17 00:00:00 2001 From: zchpeter Date: Fri, 27 Feb 2026 03:37:28 -0500 Subject: [PATCH 03/11] Use GitHub and Bytebase logos in GitOps workflow diagram - Replace text badges with actual GitHub octocat and Bytebase logos - Use PR only (remove MR references) since we focus on GitHub - Replace "Results posted to PR" box with dashed back-arrow labeled "post review" from Bytebase SQL Review to GitHub PR - Simplify to 2 databases: Test and Prod Co-Authored-By: Claude Opus 4.6 --- docs/content/docs/gitops/gitops-workflow.svg | 202 ++++++++++--------- 1 file changed, 104 insertions(+), 98 deletions(-) diff --git a/docs/content/docs/gitops/gitops-workflow.svg b/docs/content/docs/gitops/gitops-workflow.svg index b56dc9bc2..8b87aab7d 100644 --- a/docs/content/docs/gitops/gitops-workflow.svg +++ b/docs/content/docs/gitops/gitops-workflow.svg @@ -1,4 +1,4 @@ - + + + + + + + + + + + + + + + - + @@ -20,138 +34,130 @@ - - GIT + + + + + GITHUB Write SQL files migration or schema - + - - - - PR/MR created + + + + PR created - + - CI - - + CI - - - - - GIT - Create Pull Request - Open PR/MR with SQL changes - + - - - - triggers - - - - - - BYTEBASE - SQL Review - Check syntax, lint, enforce policy + + + + + + + Create Pull Request + Open PR with SQL changes - - - + + + + triggers - - - - Results posted to PR - Blocks merge if issues found + + + + + + + SQL Review + Check syntax, lint, enforce policy + + + + post + review + - + - - - - PR/MR merged + + + + PR merged - + - CD + CD - + - - - - - GIT - Merge to branch - Webhook notifies Bytebase + + + + + + + Merge to branch + Webhook notifies Bytebase - - - - triggers - - - - - - BYTEBASE - Create Rollout - Plan and stage changes + + + + triggers + + + + + + + + Create Rollout + Plan and stage changes - - - - apply + + + + apply - - - DATABASES - - - - - - - - Dev - - - - - - - - - Staging + + + + + + + + + + Test - - - - - - Prod + + + + + + Prod From c1e6d23dd8171da1bc0bf794e2b6c35b1af5e300 Mon Sep 17 00:00:00 2001 From: zchpeter Date: Fri, 27 Feb 2026 04:13:41 -0500 Subject: [PATCH 04/11] Rewrite GitOps overview page and add get-started placeholder Overview page: - Diagram with compact CI phase (no whitespace) - Concise explanation of Database as Code workflow - "When to use GitOps" section with 4 bullet points - Next Steps linking to new Get Started page Also: - Add get-started.mdx placeholder page - Add get-started to docs.json navigation Co-Authored-By: Claude Opus 4.6 --- docs/content/docs/gitops/gitops-workflow.svg | 6 +- docs/docs.json | 1 + docs/gitops/get-started.mdx | 5 + docs/gitops/overview.mdx | 178 ++----------------- 4 files changed, 19 insertions(+), 171 deletions(-) create mode 100644 docs/gitops/get-started.mdx diff --git a/docs/content/docs/gitops/gitops-workflow.svg b/docs/content/docs/gitops/gitops-workflow.svg index 8b87aab7d..6695e403c 100644 --- a/docs/content/docs/gitops/gitops-workflow.svg +++ b/docs/content/docs/gitops/gitops-workflow.svg @@ -1,4 +1,4 @@ - +