Skip to content

πŸ“– docs: plain-language default page β€” what Hive is, why it differs, hub vs spoke - #342

Merged
hivecommons-hive[bot] merged 1 commit into
mainfrom
docs/what-is-hive-plain-intro
Oct 15, 2026
Merged

hivecommons-hive[bot] merged 1 commit into
mainfrom
docs/what-is-hive-plain-intro

Conversation

@clubanderson

Copy link
Copy Markdown
Member

Motivation

Smart readers in the CNCF TOC / BOINC / Discord review path could not quickly tell what Hive is, how it differs from running an agent in a terminal, how hub and spoke fit together, or where Hive ends and Hive Commons begins.

What changed

  • Rewrote the Hive Commons default page into a short plain-language Hive introduction.
  • Added the required FAQ under #does-hive-fit-my-project with links to the relevant Hive docs and source references.
  • Moved the remaining governance/community pointers to Join Hive Commons and added a changelog fragment.

Anchor

FAQ: https://docs.hivecommons.dev/docs/community/what-is-hive-commons#does-hive-fit-my-project

Validation

  • npm test (fails locally on macOS case-insensitive filesystem in scripts/sync-hive-docs.main.test.ts; the test expects readme.md to exist and README.md not to exist, which cannot be distinguished by fs.existsSync on this filesystem)
  • npm run lint:md
  • npm run check-links
  • npm run lint
  • npm run type-check
  • npm run format:check
  • npm run build

…ub vs spoke

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
@kubestellar-prow

Copy link
Copy Markdown

[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 clubanderson 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

@netlify

netlify Bot commented Oct 15, 2026 •

Copy link
Copy Markdown

βœ… Deploy Preview for hivecommons-docs ready!

Name Link
πŸ”¨ Latest commit 31a36c9
πŸ” Latest deploy log https://app.netlify.com/projects/hivecommons-docs/deploys/6ad0d58c7257a29d72070ac8
😎 Deploy Preview https://deploy-preview-342--hivecommons-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.

@hivecommons-hive
hivecommons-hive Bot merged commit 31ff9bf into main Oct 15, 2026
12 of 13 checks passed
@hivecommons-hive

Copy link
Copy Markdown
Contributor

merged by Hive trusted-author auto-merge: author @clubanderson holds role owner and GitHub permission admin on repo; CI green at 31a36c9.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant