zombor/pergamum
1
0
Fork 0
Code Issues Pull requests 5 Projects Releases Packages 2 Wiki Activity Actions

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
pull from: bd-bookshelf-tc4u
merge into: zombor:main
Conversation 6 Commits 2 Files changed 1 +33 -71
zombor commented 2026-06-29 13:18:47 +00:00
Owner
Copy link

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.
homepage_full.png
332 KiB
wf-detail-older-execution.png
55 KiB
recompute-match-score-kebab-open.png
109 KiB
homepage_v2_full.png
313 KiB
wf-detail-older-execution.png
55 KiB
recompute-match-score-kebab-open.png
109 KiB
homepage_full.png wf-detail-older-execution.png recompute-match-score-kebab-open.png homepage_v2_full.png wf-detail-older-execution.png recompute-match-score-kebab-open.png
docs(homepage): replace AI-generated feature-box layout with human voice (bookshelf-tc4u)
All checks were successful
/ Hugo build (pull_request) Successful in 1m12s
Details
/ JS Unit Tests (pull_request) Successful in 1m33s
Details
/ Lint (pull_request) Successful in 3m13s
Details
/ E2E API (pull_request) Successful in 2m20s
Details
/ Integration (pull_request) Successful in 3m34s
Details
/ E2E Browser (pull_request) Successful in 3m19s
Details
/ Test (pull_request) Successful in 4m52s
Details
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>
zombor commented 2026-06-29 13:19:07 +00:00
Author
Owner
Copy link

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.
forgejo-actions commented 2026-06-29 13:25:07 +00:00
Copy link

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)
forgejo-actions commented 2026-06-29 13:25:20 +00:00
Copy link

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
Details
/ JS Unit Tests (pull_request) Successful in 1m33s
Details
/ Lint (pull_request) Successful in 3m13s
Details
/ E2E API (pull_request) Successful in 2m20s
Details
/ Integration (pull_request) Successful in 3m34s
Details
/ E2E Browser (pull_request) Successful in 3m19s
Details
/ Test (pull_request) Successful in 4m52s
Details
to b439a45e71
All checks were successful
/ Hugo build (pull_request) Successful in 29s
Details
/ JS Unit Tests (pull_request) Successful in 40s
Details
/ E2E API (pull_request) Successful in 2m9s
Details
/ Lint (pull_request) Successful in 2m26s
Details
/ Integration (pull_request) Successful in 3m8s
Details
/ E2E Browser (pull_request) Successful in 3m15s
Details
/ Test (pull_request) Successful in 3m53s
Details
2026-06-29 14:17:30 +00:00 Compare
zombor commented 2026-06-29 14:17:40 +00:00
Author
Owner
Copy link

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)
forgejo-actions commented 2026-06-29 14:20:15 +00:00
Copy link

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)
forgejo-actions commented 2026-06-29 14:20:21 +00:00
Copy link

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
Details
/ JS Unit Tests (pull_request) Successful in 40s
Details
/ 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.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
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.