Skip to content

Expand Argus Hub docs into a multi-page section - #317

Merged
jcsalterego merged 19 commits into
mainfrom
jchen/316-expand-argus-hub-docs
Jul 28, 2026
Merged

Expand Argus Hub docs into a multi-page section#317
jcsalterego merged 19 commits into
mainfrom
jchen/316-expand-argus-hub-docs

Conversation

@jcsalterego

Copy link
Copy Markdown
Contributor

Summary

Expands the single Argus Hub docs page into a full multi-page section under /argus-hub, matching the depth and structure of the main "Using Argus" docs.

  • Moved Argus Hub docs from one page to /argus-hub (overview) plus /argus-hub/{configuration,activity,tasks,tools,team,mcp,export}, with a new Configuration page and screenshots for each view
  • Prefixed every page's H1 with "Argus Hub: " and added a short intro to Configuration
  • Matched tone, screenshot placement and depth across pages to the rest of the docs site, and kept the overview's opening paragraph in sync with argus-hub's own README
  • Fixed a couple of stale anchors and passive-voice/redundant phrasing turned up along the way

Test plan

  • docs/.vitepress/config.ts nav and all internal cross-links verified against actual page headings
  • Confirmed /argus-hub and /argus-hub/configuration resolve on the local dev server

Refs #316

🤖 Generated with Claude Code

jcsalterego and others added 19 commits July 28, 2026 12:26
Adds a "Using Argus Hub" nav section with dedicated pages for Activity,
Tasks, Tools, Team and Export, plus a Query Hub (MCP) page covering all
8 MCP tools (the label tools were previously undocumented). argus-hub.md
now stays focused on setup/ops and links out to these instead of
duplicating them.

Closes #316

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Removes the standalone Teams nav section now that it held just one
page; Argus Hub setup/ops now leads the Using Argus Hub group instead.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- Drop the "argus-dash" hosted-backend reference; no such product
  exists, and positioning.md describes Hub as the company-run
  capability, not an alternative to a hosted one.
- Document HUB_SECRET_KEY in setup and the config table.
- Lead Docker instructions with the published GHCR image instead of
  a local build.
- Note the Labels view and the (currently unused) Settings page,
  both missing from the dashboard views table.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…enshots

- Remove em-dashes throughout (project style bans them outright);
  reword with commas, colons and conjunctions instead.
- Restructure Tools into per-topic sections matching the app's own
  section order (access layer, underused, MCP servers, friction,
  skills, tools, plugins, shared vs. solo, source comparison), closer
  to Tasks' depth than the condensed original.
- Swap in real captured screenshots for Activity, Tasks and Tools
  (retiring the older, less complete argus-hub-dashboard shot) and
  add TODO placeholders marking every still-missing screenshot
  (Team, per-user activity, Labels, Export) with the exact capture
  command for each.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Ran a seeded demo Hub (bun run demo in argus-hub), created a group and
two hub labels to get non-empty states, and captured real screenshots
for Team, one person's activity page (reached from Team), Labels and
Export, replacing the TODO placeholders left in the previous pass.

Also fixes hub-tasks.md's Hub labels section: the Labels page doesn't
actually show an applied-task count or description per label (only
name), that count is only available by querying labels over MCP.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…page

Nest all "Using Argus Hub" docs under docs/argus-hub/ so their routes
share the /argus-hub/ prefix, and split Hub's setup/deployment/privacy
guidance out of the Overview page into a new Configuration page.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…r Hub pages

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…e MCP page

Replace bare "Hub" with "Argus Hub" across the Argus Hub docs section so the
product name reads consistently, keeping identifiers (hub.db, hub.json,
HUB_SECRET_KEY, etc.) unchanged. Also rename the "Query Argus Hub from an
agent" page/nav entry to "MCP" and reorder the nav so Export sits last.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Moves docs/argus-hub/index.md to docs/argus-hub.md (sibling of the
argus-hub/ subpage directory) and updates the sidebar and cross-page
links that pointed at the trailing-slash path.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@jcsalterego jcsalterego self-assigned this Jul 28, 2026
@jcsalterego
jcsalterego merged commit f8c9d77 into main Jul 28, 2026
1 check passed
@jcsalterego
jcsalterego deleted the jchen/316-expand-argus-hub-docs branch July 28, 2026 20:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant