docs(homepage): replace AI-generated feature-box layout with human voice (bookshelf-tc4u) #839

Open
zombor wants to merge 2 commits from bd-bookshelf-tc4u into main
Owner

Summary

Rewrite docs/content/_index.md so the homepage reads like a real person built this, not templated scaffolding.

  • Hero: kept the hextra layout, Get Started + View Source CTAs, screenshots placeholder. New headline: "A self-hosted library server built for large collections." New subtitle leads with WHY — Grimmory falls over at 50k books; this is built for 250,000+.
  • Body: two paragraphs of prose explaining the origin and the design approach, replacing the "Why Pergamum" triadic feature-card grid.
  • What you can do: six short paragraphs in plain language covering the real feature set (reader, BookDrop, metadata locking, magic shelves, multi-user, bulk ops) — no card grid, no uniform cadence bullets, no AI-pattern superlatives.
  • Quick start + Open source: kept, lightly tightened.
  • Removed: the 3-card "Why Pergamum" grid and the 11-card "Features" grid entirely.

Hugo builds clean (81 pages, 0 errors).

Test plan

  • hugo --source docs --minify builds with 0 errors
  • Homepage renders with correct hero text, prose sections, Quick start code block, Open source callout
  • Rendered screenshot posted below

Screenshots

Screenshot captured locally — full-page render of the new homepage:

(See PR comment for rendered screenshot — attaching via comment API after PR creation.)

Closes bead bookshelf-tc4u on merge.

## Summary Rewrite `docs/content/_index.md` so the homepage reads like a real person built this, not templated scaffolding. - **Hero**: kept the hextra layout, Get Started + View Source CTAs, screenshots placeholder. New headline: "A self-hosted library server built for large collections." New subtitle leads with WHY — Grimmory falls over at 50k books; this is built for 250,000+. - **Body**: two paragraphs of prose explaining the origin and the design approach, replacing the "Why Pergamum" triadic feature-card grid. - **What you can do**: six short paragraphs in plain language covering the real feature set (reader, BookDrop, metadata locking, magic shelves, multi-user, bulk ops) — no card grid, no uniform cadence bullets, no AI-pattern superlatives. - **Quick start + Open source**: kept, lightly tightened. - Removed: the 3-card "Why Pergamum" grid and the 11-card "Features" grid entirely. Hugo builds clean (`81 pages, 0 errors`). ## Test plan - [ ] `hugo --source docs --minify` builds with 0 errors - [ ] Homepage renders with correct hero text, prose sections, Quick start code block, Open source callout - [ ] Rendered screenshot posted below ## Screenshots Screenshot captured locally — full-page render of the new homepage: (See PR comment for rendered screenshot — attaching via comment API after PR creation.) Closes bead bookshelf-tc4u on merge.
docs(homepage): replace AI-generated feature-box layout with human voice (bookshelf-tc4u)
All checks were successful
/ Hugo build (pull_request) Successful in 1m12s
/ JS Unit Tests (pull_request) Successful in 1m33s
/ Lint (pull_request) Successful in 3m13s
/ E2E API (pull_request) Successful in 2m20s
/ Integration (pull_request) Successful in 3m34s
/ E2E Browser (pull_request) Successful in 3m19s
/ Test (pull_request) Successful in 4m52s
6800411803
Rewrite docs/content/_index.md so it reads like a person wrote it:

- Lead with why: Grimmory falls over at 50k books; this is the Go rewrite
  built for 250,000+ from day one
- Replace the generic hero/feature-grid/quick-start scaffolding with
  narrative prose + a short tight list of what you can actually do
- Remove the two feature-card grids (11 + 3 cards) and the "Why Pergamum"
  triads that triggered the AI-generated complaint
- Keep hextra theme, Get Started and View Source CTAs, screenshots
  placeholder comment (hj9.1 follow-up), and quick-start block
- Hugo builds clean (81 pages, 0 errors)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Author
Owner

Rendered screenshot

New homepage — full page render:

Homepage full render

Hero shows the new "large collections" headline + Grimmory-origin subtitle. Body has two prose paragraphs + the "What you can do with it" section as six short paragraphs (no card grid). Quick start and Open source sections below.

## Rendered screenshot New homepage — full page render: ![Homepage full render](https://git.zombor.net/attachments/fa742e23-b0de-47eb-802e-2e0f729ccdc9) Hero shows the new "large collections" headline + Grimmory-origin subtitle. Body has two prose paragraphs + the "What you can do with it" section as six short paragraphs (no card grid). Quick start and Open source sections below.

Workflow Detail page screenshot (wf-detail-older-execution)

Older completed ContinueAsNew epoch detail — execution ID and state visible, Cancel absent.

wf-detail-older-execution

**Workflow Detail page screenshot** (wf-detail-older-execution) Older completed ContinueAsNew epoch detail — execution ID and state visible, Cancel absent. ![wf-detail-older-execution](/attachments/6b2f406e-c3d3-4201-9c25-0481af4a52d9)

Recompute Match Score — kebab open screenshot (recompute-match-score-kebab-open)

recompute-match-score-kebab-open

**Recompute Match Score — kebab open screenshot** (recompute-match-score-kebab-open) ![recompute-match-score-kebab-open](/attachments/87052218-9022-42b9-bfc4-6c5f78b98ef1)
zombor force-pushed bd-bookshelf-tc4u from 6800411803
All checks were successful
/ Hugo build (pull_request) Successful in 1m12s
/ JS Unit Tests (pull_request) Successful in 1m33s
/ Lint (pull_request) Successful in 3m13s
/ E2E API (pull_request) Successful in 2m20s
/ Integration (pull_request) Successful in 3m34s
/ E2E Browser (pull_request) Successful in 3m19s
/ Test (pull_request) Successful in 4m52s
to b439a45e71
All checks were successful
/ Hugo build (pull_request) Successful in 29s
/ JS Unit Tests (pull_request) Successful in 40s
/ E2E API (pull_request) Successful in 2m9s
/ Lint (pull_request) Successful in 2m26s
/ Integration (pull_request) Successful in 3m8s
/ E2E Browser (pull_request) Successful in 3m15s
/ Test (pull_request) Successful in 3m53s
2026-06-29 14:17:30 +00:00
Compare
Author
Owner

Revised screenshot (v2)

Fixed two issues from the first version:

  1. Visual design restored — hextra feature-card grid is back with the human copy
  2. Grimmory positioning fixed — hero subtitle now describes Pergamum on its own terms; Grimmory moved to a warm lower "Built on Grimmory's data model" section

Homepage v2 full render

## Revised screenshot (v2) Fixed two issues from the first version: 1. **Visual design restored** — hextra feature-card grid is back with the human copy 2. **Grimmory positioning fixed** — hero subtitle now describes Pergamum on its own terms; Grimmory moved to a warm lower "Built on Grimmory's data model" section ![Homepage v2 full render](https://git.zombor.net/attachments/83cd9174-bdbb-4d8d-a86b-8e412ea673a6)

Workflow Detail page screenshot (wf-detail-older-execution)

Older completed ContinueAsNew epoch detail — execution ID and state visible, Cancel absent.

wf-detail-older-execution

**Workflow Detail page screenshot** (wf-detail-older-execution) Older completed ContinueAsNew epoch detail — execution ID and state visible, Cancel absent. ![wf-detail-older-execution](/attachments/82055b9d-31a8-4258-bd11-49b4b2b1f518)

Recompute Match Score — kebab open screenshot (recompute-match-score-kebab-open)

recompute-match-score-kebab-open

**Recompute Match Score — kebab open screenshot** (recompute-match-score-kebab-open) ![recompute-match-score-kebab-open](/attachments/27a70e34-90a8-444b-91e1-27fa5591a332)
All checks were successful
/ Hugo build (pull_request) Successful in 29s
/ JS Unit Tests (pull_request) Successful in 40s
/ E2E API (pull_request) Successful in 2m9s
Required
Details
/ Lint (pull_request) Successful in 2m26s
Required
Details
/ Integration (pull_request) Successful in 3m8s
Required
Details
/ E2E Browser (pull_request) Successful in 3m15s
Required
Details
/ Test (pull_request) Successful in 3m53s
Required
Details
This pull request is blocked because it's outdated.
This branch is out-of-date with the base branch
You are not authorized to merge this pull request.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin bd-bookshelf-tc4u:bd-bookshelf-tc4u
git switch bd-bookshelf-tc4u
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
zombor/pergamum!839
No description provided.