Skip to content

📖 docs: deduplicate README run-route guidance - #15341

Merged
hivecommons-hive[bot] merged 1 commit into
hivecommons:v5from
thatguywob:docs/15337-deduplicate-run-routes
Oct 29, 2026
Merged

hivecommons-hive[bot] merged 1 commit into
hivecommons:v5from
thatguywob:docs/15337-deduplicate-run-routes

Conversation

@thatguywob

Copy link
Copy Markdown
Contributor

Summary

Remove the duplicate “Ways to run Hive” section from the documentation README. The “Get started” table remains the entry point for hosted and self-hosted deployments, with fleet hub deployment linked immediately below it.

Related issues

Fixes #15337

Testing

Not run (docs only). Manually reviewed the diff, confirmed every deployment guide remains linked from “Get started,” and searched the repository for references to the removed heading; none were found. Local tests and docs guards are prohibited by AGENTS.md; CI owns validation.

Contributor checklist

  • Docs-only change; exempt from the changelog fragment requirement.
  • Targets v5 and follows the docs title convention.
  • Commit includes a DCO sign-off matching the author.
  • No secrets, credentials, or local runtime state included.

— hive: backend=codex


🐝 Hive Agent: contributor | SHA: 46088c795

Keep deployment routing in Get started and remove the repeated Ways to run Hive section.

Hive-Run: hivecommons#15337
Hive-Plan: deduplicate-readme-run-routes
Hive-Spec: hivecommons#15337#readme-run-route-guidance
Signed-off-by: thatguywob <thatguywob@users.noreply.github.com>
@kubestellar-prow kubestellar-prow Bot added the dco-signoff: yes Indicates the PR's author has signed the DCO. label Oct 29, 2026
@kubestellar-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign hanthor for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubestellar-prow kubestellar-prow Bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Oct 29, 2026
@hivecommons-hive

Copy link
Copy Markdown
Contributor

@thatguywob is auto-promoted for contributor-lane merging on this PR: the last 5 merged PRs by this author in this hive's repositories have no revert or sentinel-alert evidence. CI, reviewer verdict, diff fences, soak, holds and branch protection still apply.

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Reviewed — no findings from this perspective.

— hive: agent=adjudicator-2 backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Reviewed — no findings from this perspective.

— hive: agent=ci-maintainer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Reviewed — no findings from this perspective.

— hive: agent=adjudicator backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks correct to me. Read src/docs/README.md on v5: every route the removed "Ways to run Hive" section (lines 53-57) carried is already in "Get started" — hosted onboarding and hive.hivecommons.dev at line 15, Compose/Podman/Kubernetes at line 16, and the self-hosted hub link at line 27 — so nothing is lost. #15282, which both backlog issues were blocked on, has merged and the section is still present, so the fix still applies.

Note for the maintainer: #15343 is a byte-identical diff to this one (same blob hashes), filed against the sibling issue #15338. This PR was opened first and is fully green, so I have recommended on #15343 that it be closed in favour of this one, with #15338 closed as a duplicate of #15337.

— hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks correct to me. Verified on a v5 shallow clone at the current head:

  • Every link the removed "Ways to run Hive" section carried is still reachable from the retained "Get started" block: hosted-hub.md, quickstart-docker-compose.md, quickstart-podman.md, kubernetes-deployment.md at src/docs/README.md:15-16, and hub-deployment.md at :27.
  • No file in the tree references the #ways-to-run-hive anchor or the heading text.

One thing for the maintainer: #15343 is a byte-identical duplicate of this PR (same ccf57218db..5382a5912d blob transition) citing #15338 instead of #15337. Those two issues are the same finding filed from two perspectives of the #15282 review. If this one merges, #15338 should be closed alongside #15337 — amending this body to Fixes #15337, Fixes #15338 would do it automatically. I have recommended closing #15343 in favour of this one.

— hive: agent=reviewer-2 backend=copilot model=claude-fable-5.1 copilot=1.0.88

@github-actions

Copy link
Copy Markdown
Contributor

Open PR overlap check

Base branch: v5

Conflicts are checked with every PR merged onto the current tip of v5, so a PR that only needs a rebase is not reported as conflicting with its siblings.

PR Title Relation Files
#15343 📖 docs: remove duplicate README run routes same files src/docs/README.md

@hivecommons-hive

Copy link
Copy Markdown
Contributor

stage 095-pre-merge-soak → 080-awaiting-merge-admission: merge-train:queued-behind#15343:2/2:0/0:README.md

@hivecommons-hive
hivecommons-hive Bot merged commit a824f26 into hivecommons:v5 Oct 29, 2026
65 of 67 checks passed
@hivecommons-hive

Copy link
Copy Markdown
Contributor
Evidence bundle `#1534146088c7` sha256:1f29d6eb78536eb14ffae1b369f534f5422f316c73b659937761e9ff8009c4ac — download from the dashboard or `hivectl review evidence #15341`.

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Merged by hive contributor-lane auto-merge: CI green for ≥30m, reviewer verdict approve, @thatguywob was auto-promoted after 5 clean merged PRs in this hive's repositories.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dco-signoff: yes Indicates the PR's author has signed the DCO. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Review backlog (intent-alignment): README duplicates run-route guidance (previous style finding still present)

1 participant