Skip to content

Redesign catalog navigation and standardize all 82 use-case summaries - #26

Merged
aliaihub merged 1 commit into
mainfrom
redesign-hermes-catalog
Oct 23, 2026
Merged

aliaihub merged 1 commit into
mainfrom
redesign-hermes-catalog

Conversation

@aliaihub

Copy link
Copy Markdown
Owner

Readers currently have to scan long descriptions across 14 mixed categories to find a suitable Hermes workflow. This redesign preserves all 82 entries and gives them a consistent way to compare outcomes and prerequisites.

  • Split discovery into seven goal-based categories and four setup/extension categories, with six featured starting points.
  • Replace uneven catalog descriptions with compact outcome and format columns. Add Outcome, Requires, Available, and Validation summaries to every page.
  • Move installation below discovery, correct the three demos versus planning-walkthrough distinction, and repair badge ownership.
  • Add catalog.json, a standard-library renderer with --check, contributor guidance, and a catalog-consistency workflow.

Validation: all 82 entries occur exactly once in the full listing; generated README links and page backlinks resolve; original page bodies and source URLs are preserved; generation is idempotent; git diff --check passes. Checked the CI selector against all 82 real edits plus substantive-body and new-URL changes.

Source verification still runs for every substantive page edit or URL change. Generated-summary-only changes are identified by comparing the complete original body and URL set, and are checked by the renderer instead. No source-check thresholds or URL-check behavior were changed.

A separate read-only preflight of 94 existing non-GitHub URLs found 72 responding, 2 blocked, and 20 failures, including local/template addresses and pre-existing 404s. Those sources were not changed or relabeled as passing. The legacy weather-market page's missing primary URL is explicitly noted. No integrations were executed during this redesign.

@github-actions

Copy link
Copy Markdown

Usecase Verification Report

No usecase files changed.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-23T04:24:05.693438Z 0f532e5 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@aliaihub
aliaihub merged commit a3d459b into main Oct 23, 2026
2 checks passed

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0f532e52de

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/render-catalog.py
args = parser.parse_args()
try:
data = load_catalog()
outputs = {ROOT / "README.md": render_readme(data)}

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Preserve hand-edited README sections when rendering

Running the documented renderer replaces the entire README with render_readme(data), so unrelated edits to installation, evidence, licensing, acknowledgements, or introductory text are silently discarded whenever a contributor updates the catalog. This conflicts with the contributor guidance that only generated README rows should not be edited by hand; limit replacement to explicitly marked generated regions (and the count badge) so ordinary README maintenance survives a catalog render.

Useful? React with 👍 / 👎.

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