Skip to content

refactor: src/docs/dashboard-sections.md is a merge hotspot — split into 4 sections #15674

Closed

Description

@hivecommons-hive

src/docs/dashboard-sections.md keeps being touched by pull requests that are open at the same time. In the last 7 days 34 distinct PRs changed it, 117 pairs of them were open concurrently, and 0 merge conflicts or rebase failures were blamed on it. Every concurrent pair is a rebase someone (or the merge train) has to redo, and a 1517-line file makes each of those rebases slower and riskier.

This is a document, so the split is by section: each top-level ## area becomes its own file under a directory named after this one, with a short index page that links them (the way docs/api-reference.md became docs/api-reference/<area>.md). Keep every heading anchor reachable from the index.

Evidence

metric value
window 7 days
distinct PRs 34
concurrent PR pairs 117
conflicts attributed 0
lines 1517
kind doc
score 175.5

PRs in window: #15425, #15445, #15449, #15455, #15457, #15468, #15470, #15477, #15480, #15485, #15526, #15545, #15547, #15553, #15554, #15556, #15570, #15572, #15574, #15577, #15588, #15590, #15591, #15593, #15601, #15612, #15616, #15619, #15620, #15639, #15652, #15657, #15658, #15668

Sections

  • ACMM Eval
  • Advisory
  • Advisory Digest
  • Agent Logs
  • Agent activity
  • Agents
  • Approvals
  • Audit Log
  • Contributors
  • Cost
  • Diagnostics
  • Experiment Lab
  • FAQ
  • Fleet Report Preview
  • Governor
  • Hive Advice
  • Hive activity monitor
  • Inception
  • Knowledge
  • Lifecycle Timeline
  • Overview
  • PRs by model
  • Platform
  • Projects
  • Queue
  • Ready to level up?
  • Review
  • Review Pipeline
  • Runs
  • Throughput
  • Tokens
  • Words used on this page

Split proposal

  1. src/docs/dashboard-sections/README.md — index linking every section
  2. src/docs/dashboard-sections/acmm_eval.md — section “ACMM Eval”
  3. src/docs/dashboard-sections/advisory.md — section “Advisory”
  4. src/docs/dashboard-sections/advisory_digest.md — section “Advisory Digest”
  5. src/docs/dashboard-sections/agent_logs.md — section “Agent Logs” and the 28 remaining sections

Don't splinter

  • At most 4 resulting files, each at least 150 lines; fewer is better.
  • No behaviour change; the package, its exported API and every import path stay the same.
  • Tests move with the code they cover; no new test helpers.
  • One PR; land it when the file has no open PRs against it.

Filed by the hive's merge-hotspot advisor (GET /api/hotspots). It will not file another issue for this file while this one is open.

Activity

  1. added
    kind/cleanupCategorizes issue or PR as related to cleaning up code, process, or technical debt.
    agent/ci-maintainerCreated or modified by the ci-maintainer agent
    on Oct 30, 2026
  2. added
    help wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.
    on Oct 30, 2026
  3. hivecommons-hive commented on Oct 30, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 2h0m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/ci-maintainerCreated or modified by the ci-maintainer agenthelp wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.kind/cleanupCategorizes issue or PR as related to cleaning up code, process, or technical debt.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions