Skip to content

Docs: publish Hive's operator guides on the site (securing-your-hive, Level 6 best practices) #195

Description

@Danathar

Two Hive operator guides have no page on docs.hivecommons.dev, so an operator reading the site is sent to GitHub for one of them and will never be shown the other.

What I saw

The site pulls Hive pages from hivecommons/hive (src/docs/, branch v5) at build time, but only the files named in the files list in scripts/sync-hive-docs.ts. A page that is not on that list has no address on the site.

Guide In hivecommons/hive On the site
securing-your-hive.md, the first-time operator's guide to who can make Hive do what in a repository On v5 since 2026-09-30 (hivecommons/hive#9786) No. It is in neither scripts/sync-hive-docs.ts nor src/app/docs/page-map.ts.
The Level 6 best-practices guide Requested in hivecommons/hive#10516. Not written yet. No

Checked on 2026-10-04:

  • https://docs.hivecommons.dev/docs/hive/security/securing-your-hive returns 404.
  • The site's Introduction page and its Security model page both link to the guide, and both links leave the site for https://github.com/hivecommons/hive/blob/v5/src/docs/securing-your-hive.md.

What I'm asking for

1. Now: publish securing-your-hive.md. The same change #177 made for the integration guide:

  • add the file to files in scripts/sync-hive-docs.ts
  • add it to the Security group of NAV_STRUCTURE_HIVE in src/app/docs/page-map.ts
  • commit the synced copy and a changelog fragment

2. Later: publish the Level 6 best-practices guide the same way, in the Operations group. Do this only after hivecommons/hive#10515 is closed. Until a maintainer who runs a Level 6 hive has signed that guide off, it carries a notice at the top saying it has not been reviewed, and it should not be on the public site in that state. If the notice is still on the page when this issue is picked up, do step 1 only and leave this issue open.

Done when

Activity

  1. hivecommons-hive commented on Oct 4, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by @mendezr (contributor on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-04 15:52 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  2. hivecommons-hive commented on Oct 4, 2026

    @hivecommons-hive
    Contributor

    Claimed by mendezr until 2026-10-04T19:22:35Z. The claim lapses on its own after that; a pull request referencing this issue supersedes it.

  3. added
    hive/likely-doneHive verified that a merged PR references or claims this issue; pending confirmation
    on Oct 4, 2026
  4. hivecommons-hive commented on Oct 4, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-04 22:29 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  5. hivecommons-hive commented on Oct 4, 2026

    @hivecommons-hive
    Contributor

    Verified against merged #196: step 1 is done (securing-your-hive.md added to the sync manifest, Security nav group, synced copy, Introduction/Security model links now internal, tests and changelog fragment). Remaining: step 2, the Level 6 best-practices guide under Operations. Per this issue it is gated on hivecommons/hive#10515 being closed and the review notice being removed from the guide; #196 states #10515 is still open. Nothing further can be published yet, so this stays open.


    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

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

  6. removed
    hive/likely-doneHive verified that a merged PR references or claims this issue; pending confirmation
    on Oct 4, 2026
  7. hivecommons-hive commented on Oct 4, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 00:36 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  8. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 03:04 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  9. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 05:12 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  10. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 07:23 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  11. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 09:31 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  12. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 11:39 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  13. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 13:44 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  14. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    Blocked on upstream: step 2 (publish the Level 6 best-practices guide under Operations) requires hivecommons/hive#10515 to close and the guide itself to exist — hivecommons/hive#10516 (write the guide) is also still open; the only Level 6 artifact on hive v5 today is src/pkg/config/packs/level-6.yaml (config, not prose). Nothing to port yet. Labelled blocked; remove it once #10515/#10516 close and the guide drops its not-reviewed notice, then publish it the same way #196 did step 1.


    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

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

  15. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 15:55 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  16. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    Step 2 is still blocked: hivecommons/hive#10515 (sign-off for the Level 6 best-practices guide) is open and on hold awaiting a maintainer review, and the guide from hivecommons/hive#10516 is not yet in src/docs/ on v5, so there is no guide without the review notice to publish. No changes made; this stays open until #10515 closes.


    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

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

  17. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 18:07 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  18. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 20:17 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  19. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-05 22:29 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  20. hivecommons-hive commented on Oct 5, 2026

    @hivecommons-hive
    Contributor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x) until 2026-10-06 01:04 UTC. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  21. added
    hive/covered-by-prHive verified that an open PR references or claims this issue; still actionable until confirmed
    on Oct 5, 2026
  22. removed
    hive/covered-by-prHive verified that an open PR references or claims this issue; still actionable until confirmed
    on Oct 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions