docs(website): add User Stories and Use Cases collage page#18282
Merged
Conversation
Adds a new top-of-sidebar docs page at /docs/user-stories that is a masonry-style collage of 99 real user stories sourced from X/Twitter, GitHub issues/PRs, Reddit, Hacker News, YouTube, blogs (Medium, Substack, dev.to), podcasts, LinkedIn, GitHub Gists, and Product Hunt. Every tile links to the original post/issue/video/gist where someone described a specific use case: personal assistants, dev workflows, trading bots, research briefs, family WhatsApp agents, Kubernetes deployments, legal-domain self-hosted setups, and more. - docs/user-stories.mdx: MDX entry mounting the collage component - src/components/UserStoriesCollage: React component with category + source filters, CSS-columns masonry layout, per-category accent colors - src/data/userStories.json: source-of-truth dataset (force-added; the root .gitignore's unanchored 'data/' rule would otherwise swallow it, same reason skills.json is explicitly listed in website/.gitignore) - sidebars.ts: link added at the top of the docs sidebar
alt-glitch
added
type/docs
jooray
added a commit
to jooray/hermes-agent
that referenced
this pull request
May 1, 2026
* upstream/main: (208 commits) fix: kanban button fix(telegram): send seed message after creating DM topics (NousResearch#18334) fix(yuanbao): enforce owner identity check on group slash commands docs(website): add User Stories and Use Cases collage page (NousResearch#18282) fix: prevent tui rebuilding assets fix(paths): route achievements plugin + profile-tui through HERMES_HOME docs: publish llms.txt and llms-full.txt for agent-friendly ingestion (NousResearch#18276) docs: add Persistent Goals (/goal) feature page (NousResearch#18275) fix(moonshot): also strip nullable/enum after anyOf collapse chore(release): map hendrixfreire for moonshot salvage fix(moonshot): fill missing type before enum cleanup to handle anyOf branches without explicit type chore(release): add mikeyobrien to AUTHOR_MAP fix(gateway): honor MATRIX_HOME_ROOM in onboarding feat: /goal — persistent cross-turn goals (Ralph loop) (NousResearch#18262) docs(sidebar): collapse exploding skills tree to a single Skills node (NousResearch#18259) feat(update): add --yes/-y flag to skip interactive prompts (NousResearch#18261) feat(gateway): auto-delete slash-command system notices after TTL (NousResearch#18266) fix(curator): rewrite cron job skill refs after consolidation (NousResearch#18253) fix(deepseek): use non-empty reasoning_content placeholder for V4 Pro thinking mode fix(compression): include system prompt + tool schemas in token estimates (NousResearch#18265) ... # Conflicts: # tools/tts_tool.py
donald131
pushed a commit
to donald131/hermes-agent
that referenced
this pull request
May 2, 2026
…rch#18282) Adds a new top-of-sidebar docs page at /docs/user-stories that is a masonry-style collage of 99 real user stories sourced from X/Twitter, GitHub issues/PRs, Reddit, Hacker News, YouTube, blogs (Medium, Substack, dev.to), podcasts, LinkedIn, GitHub Gists, and Product Hunt. Every tile links to the original post/issue/video/gist where someone described a specific use case: personal assistants, dev workflows, trading bots, research briefs, family WhatsApp agents, Kubernetes deployments, legal-domain self-hosted setups, and more. - docs/user-stories.mdx: MDX entry mounting the collage component - src/components/UserStoriesCollage: React component with category + source filters, CSS-columns masonry layout, per-category accent colors - src/data/userStories.json: source-of-truth dataset (force-added; the root .gitignore's unanchored 'data/' rule would otherwise swallow it, same reason skills.json is explicitly listed in website/.gitignore) - sidebars.ts: link added at the top of the docs sidebar
vasukotturu4-netizen
approved these changes
May 2, 2026
nickdlkk
pushed a commit
to nickdlkk/hermes-agent
that referenced
this pull request
May 11, 2026
…rch#18282) Adds a new top-of-sidebar docs page at /docs/user-stories that is a masonry-style collage of 99 real user stories sourced from X/Twitter, GitHub issues/PRs, Reddit, Hacker News, YouTube, blogs (Medium, Substack, dev.to), podcasts, LinkedIn, GitHub Gists, and Product Hunt. Every tile links to the original post/issue/video/gist where someone described a specific use case: personal assistants, dev workflows, trading bots, research briefs, family WhatsApp agents, Kubernetes deployments, legal-domain self-hosted setups, and more. - docs/user-stories.mdx: MDX entry mounting the collage component - src/components/UserStoriesCollage: React component with category + source filters, CSS-columns masonry layout, per-category accent colors - src/data/userStories.json: source-of-truth dataset (force-added; the root .gitignore's unanchored 'data/' rule would otherwise swallow it, same reason skills.json is explicitly listed in website/.gitignore) - sidebars.ts: link added at the top of the docs sidebar
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
New top-of-sidebar docs page at
/docs/user-stories— a masonry-style collage of 99 real user stories scraped from X/Twitter, GitHub issues and PRs, Reddit, Hacker News, YouTube, blogs (Medium, Substack, dev.to), podcasts, LinkedIn, GitHub Gists, and Product Hunt. Every tile links directly to the original post/issue/video/gist where someone describes a specific Hermes Agent use case.Coverage
Across 15 categories: Dev Workflow, Personal Assistant, Integrations, Meta and Ecosystem, Business Ops, Enterprise, Content Creation, Research, Messaging, Cost Optimization, Trading and Markets, Creative, Privacy / Self-Hosted, Marketing, General.
Highlights (to give a sense of the mix):
Changes
website/docs/user-stories.mdx— MDX entry point, mounts the componentwebsite/src/components/UserStoriesCollage/— React component with category and source filters, CSS-columns masonry, per-category accent colorswebsite/src/data/userStories.json— source-of-truth dataset (force-added; the root `.gitignore`'s unanchored `data/` rule would otherwise swallow it, same reason `skills.json` is explicitly listed in `website/.gitignore`)website/sidebars.ts— link added at the top of the docs sidebarValidation
Adding new stories
The footer invites contributors to edit `website/src/data/userStories.json` and open a PR, or share the link in the Nous Discord.