Skip to content

Reconcile enterprise/cloud doc divergence + add bump-last-updated tooling - #1547

Closed
justinegeffen wants to merge 35 commits into
masterfrom
enterprise-cloud-divergence-audit
Closed

justinegeffen wants to merge 35 commits into
masterfrom
enterprise-cloud-divergence-audit

Conversation

@justinegeffen

Copy link
Copy Markdown
Contributor

Summary

  • Fixes drift bugs surfaced by an enterprise vs cloud doc audit (broken refs, half-completed rebrands, regressions, UI-label inconsistencies, stale Bitbucket flow, etc.)
  • Normalizes frontmatter date format across both trees to date created: "YYYY-MM-DD" + last updated: "YYYY-MM-DD"
  • Adds a bump-last-updated pre-commit hook + extends pre-commit-fix.yaml to auto-trigger on PRs so last updated: stays current without manual effort

The full per-file rationale (decisions, ports, audit corrections, deliberately-untouched items) lives in enterprise-cloud-divergence-audit.md. That doc is the canonical decision log — it deliberately keeps this PR description short.

Test plan

  • Confirm the new bump-last-updated hook works locally (pre-commit run bump-last-updated --all-files)
  • Confirm the extended pre-commit-fix.yaml workflow runs on this PR's synchronize event and that the bot only commits a bump if dates are stale
  • Spot-check a few of the user-direction calls (R-IDE rebrand, "Revision" UI label, studio:execute Launch=❌, j21-26.04 launcher row)
  • Verify the Antigravity skill port renders correctly on the preview build
  • Verify the Bitbucket section update on Enterprise renders correctly

🤖 Generated with Claude Code

…ling

Fixes drift bugs surfaced by the enterprise vs cloud audit, normalizes
frontmatter date format across both trees, and adds a pre-commit hook +
CI auto-trigger so last updated dates stay current. Full per-file
rationale in enterprise-cloud-divergence-audit.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@netlify

netlify Bot commented Jun 8, 2026

Copy link
Copy Markdown

Deploy Preview for seqera-docs ready!

Name Link
🔨 Latest commit 9efc0c7
🔍 Latest deploy log https://app.netlify.com/projects/seqera-docs/deploys/6a91d3d719cbe90008e1f74b
😎 Deploy Preview https://deploy-preview-1547--seqera-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@justinegeffen justinegeffen added 1. Editor review Needs a language review 1. Dev/PM/SME Needs a review by a Dev/PM/SME do not merge Do not merge until this label is removed claude-code-assisted Vibe-coded but with human oversight and guidance. Must be validated by another human and co-pilot. content-improvement labels Jun 8, 2026

@christopher-hakkaart christopher-hakkaart left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Most of this PR is cosmetic and date added and changed improvements. So it looks worse than it actually is.

95% of these changes are not offensive.

I've been through the changes and flagged anything that I think needs checked. IMO - everything else can be skimmed.

The report at the end flags some important differences and can be reviewed separately for quick wins.

Comment thread .github/scripts/bump-last-updated.py
Comment thread platform-enterprise_docs/co-scientist/skill-antigravity.md
Comment thread platform-enterprise_docs/functionality_matrix/overview.md
Comment thread platform-enterprise_docs/git/overview.md
Comment thread platform-enterprise_docs/orgs-and-teams/roles.md
Comment thread platform-enterprise_docs/pipelines/versioning.md Outdated
Comment thread platform-enterprise_docs/secrets/overview.md Outdated
justinegeffen and others added 11 commits June 9, 2026 21:57
Co-authored-by: Chris Hakkaart <chris.hakkaart@seqera.io>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Co-authored-by: Chris Hakkaart <chris.hakkaart@seqera.io>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Per PR review (christopher-hakkaart): pre-commit hook now fails explicitly
with the exact fix command, matching the existing check-doc-tags pattern.
CI workflow still auto-bumps on PR via a dedicated step so fork
contributors and skipped local hooks merge with current dates.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
@justinegeffen justinegeffen removed the do not merge Do not merge until this label is removed label Jun 12, 2026
@christopher-hakkaart

Copy link
Copy Markdown
Member

I'll check the scripts again next week. But otherwise looking good.

Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
@justinegeffen

Copy link
Copy Markdown
Contributor Author

@copilot resolve the merge conflicts in this pull request

Copilot AI commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

The merge conflicts were already resolved in commit 89536a1.

The branch also had a failing pre-commit check due to three files with stale last updated: dates after the master merge — fixed in the latest commit by bumping them to today (2026-07-06):

  • platform-cloud/docs/compute-envs/preflight-checks.mdx
  • platform-cloud/docs/getting-started/quickstart-demo/add-data.md
  • platform-cloud/docs/getting-started/deployment-options.md

The Lint prose failure is a GitHub API size limit — the PR touches >300 files, so reviewdog can't fetch the diff. That's a known limitation of large PRs and isn't blocking.

@justinegeffen

Copy link
Copy Markdown
Contributor Author

@copilot resolve the merge conflicts in this pull request

Copilot AI commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Resolved in commit a370e98. Two new master commits (#1632, #1633) had landed since the last merge, causing conflicts in three files. Resolved by taking master's updated content and keeping the normalized frontmatter date format from the branch:

  • platform-cloud/docs/data-privacy/overview.md
  • platform-enterprise_docs/data-privacy/overview.md
  • platform-enterprise_docs/limits/overview.md

@justinegeffen

Copy link
Copy Markdown
Contributor Author

@copilot resolve the merge conflicts in this pull request

Copilot AI commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Resolved in commit 466e886. Master had accumulated 13 new commits since the last merge, causing conflicts in 7 files plus a modify/delete conflict:

  • fusion_docs/troubleshooting.md — accepted master's deletion (master restructured it into a subdirectory)
  • 4 date-only conflicts (data-explorer ×2, data-lineage ×2) — took master's content, bumped last updated: to today
  • agent/overview.md (cloud + enterprise) — took master's EDU-1218 rewrite (significantly expanded HPC guidance), kept normalized date format
  • studios_troubleshooting.md — took master's improved section heading (#### RStudio session initializes with error), which also removed a duplicate GPU section that was in our branch

@justinegeffen

Copy link
Copy Markdown
Contributor Author

@copilot resolve the merge conflicts in this pull request

Seqera Docs Bot and others added 2 commits July 29, 2026 16:59
…vergence-audit

# Conflicts:
#	.github/scripts/README.md
#	platform-cloud/docs/compute-envs/azure-cloud.md
#	platform-cloud/docs/compute-envs/google-cloud-batch.md
#	platform-cloud/docs/compute-envs/google-cloud.md
#	platform-cloud/docs/sso/single-sign-on.md
#	platform-cloud/docs/troubleshooting_and_faqs/sso_troubleshooting.md
#	platform-cloud/docs/troubleshooting_and_faqs/studios_troubleshooting.md
#	platform-enterprise_docs/compute-envs/google-cloud-batch.md
#	platform-enterprise_docs/enterprise/configuration/authentication/entra.md
#	platform-enterprise_docs/enterprise/configuration/authentication/keycloak.md
#	platform-enterprise_docs/enterprise/configuration/authentication/okta.md
#	platform-enterprise_docs/enterprise/general_troubleshooting.md
#	platform-enterprise_docs/troubleshooting_and_faqs/troubleshooting.md

Copilot AI commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Resolved in fb10433. 13 conflicts from the latest master commits (PRs #1653#1690):

  • Date-only conflicts (8 files: azure-cloud, google-cloud-batch ×2, google-cloud, sso, sso_troubleshooting, studios_troubleshooting, troubleshooting): took the branch's last updated: "2026-07-29".
  • Modify/delete conflicts (4 files: entra.md, keycloak.md, okta.md, general_troubleshooting.md): accepted master's deletion — these were intentionally restructured in docs: Merge OAuth page and standardize troubleshooting #1654 ("Merge OAuth page and standardize troubleshooting").
  • README.md: kept both the bump-last-updated.py section (from this branch) and the new docs-diff-since-release.sh section (from master).

Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
@justinegeffen justinegeffen added the validating Validating/checking review feedback. label Aug 20, 2026
Comment thread enterprise-cloud-divergence-audit.md
Comment thread enterprise-cloud-divergence-audit.md
Comment thread enterprise-cloud-divergence-audit.md
Signed-off-by: Justine Geffen <justinegeffen@users.noreply.github.com>
@justinegeffen
justinegeffen deleted the enterprise-cloud-divergence-audit branch September 15, 2026 23:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

1. Dev/PM/SME Needs a review by a Dev/PM/SME 1. Editor review Needs a language review claude-code-assisted Vibe-coded but with human oversight and guidance. Must be validated by another human and co-pilot. deslop-to-do validating Validating/checking review feedback.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants