From 5fb447cf2182cb7396f5f2b29a9c5d5a2eb812d5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Andr=C3=A9=20Padez?= Date: Mon, 31 Aug 2026 00:12:08 +0100 Subject: [PATCH] the panels stop explaining themselves MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit "The About page, in the order it is shown: a header, the text about you, the product, and the manifesto." above four bands headed Header, About us, Product and Manifesto. "The photograph at the top, and the line over it" above a photograph at the top and a line over it. "Who you are" above a box headed About us. Every one was a caption for something already visible, and together they were most of the vertical space before any content — so the actual work started below the fold on a laptop. The person using this is not a developer and is not a child. A heading names a thing; a sentence underneath saying what the thing is says it twice and trusts them less each time. Removed from About, Home, Galleries and the record sections. What stays is anything reporting STATE rather than describing furniture — a count of photographs, a loading line, an error, a save confirmation — because those say something the screen does not. Co-Authored-By: Claude Opus 5 (1M context) --- web/sections/AboutPanel.tsx | 32 +++++++------------------------- web/sections/GalleriesPanel.tsx | 7 +------ web/sections/HomePanel.tsx | 10 +--------- web/sections/RecordsPanel.tsx | 2 -- web/sections/records.ts | 5 ----- 5 files changed, 9 insertions(+), 47 deletions(-) diff --git a/web/sections/AboutPanel.tsx b/web/sections/AboutPanel.tsx index 1b1167b..6846c9f 100644 --- a/web/sections/AboutPanel.tsx +++ b/web/sections/AboutPanel.tsx @@ -137,22 +137,13 @@ export const AboutPanel = () => { return (
-
-

- The About page, in the order it is shown: a header, the text about you, the product, and the - manifesto. -

- {/* Confirmation lives with the content rather than in the bar, because the bar's own button - has already gone back to saying "Save" by the time anybody looks up. */} - {saved && Saved} -
+ {/* Confirmation only. The order of the bands is the order of the page, which the bands + themselves already say — a sentence explaining that was a caption for something visible. */} + {saved &&

Saved

} {/* ── HEADER: a photograph and a phrase over it ─────────────────────────────────────────── */}
-
-

Header

-

The photograph at the top, and the line over it.

-
+

Header

{/* 21/9 because that is what the page uses — `aspect-[21/9]` in about/partials.tsx. The two have to agree or the admin shows a shape the site does not have, which is worse than showing @@ -179,19 +170,13 @@ export const AboutPanel = () => { {/* ── ABOUT US ─────────────────────────────────────────────────────────────────────────── */}
-
-

About us

-

Who you are.

-
+

About us

{/* ── PRODUTO: a video beside its text ─────────────────────────────────────────────────── */}
-
-

Product

-

What you make, and a video of it being made.

-
+

Product

{/* 16/9, matching the `aspect-video` the product block draws. */} { {/* ── MANIFESTO ────────────────────────────────────────────────────────────────────────── */}
-
-

Manifesto

-

What you stand for.

-
+

Manifesto

diff --git a/web/sections/GalleriesPanel.tsx b/web/sections/GalleriesPanel.tsx index 9a3caab..8e47deb 100644 --- a/web/sections/GalleriesPanel.tsx +++ b/web/sections/GalleriesPanel.tsx @@ -142,12 +142,7 @@ export const GalleriesPanel = () => { return (
-
-

Galleries

-

- A named set of media, in an order. Any page can use one, and they all change together. -

-
+

Galleries

{error &&

{error}

} diff --git a/web/sections/HomePanel.tsx b/web/sections/HomePanel.tsx index 7e92474..2902d9e 100644 --- a/web/sections/HomePanel.tsx +++ b/web/sections/HomePanel.tsx @@ -155,7 +155,6 @@ export const HomePanel = () => {

Intro

-

The paragraph under the hero.

{saved && ( @@ -173,7 +172,6 @@ export const HomePanel = () => {

Hero

-

The video or image across the top of the page.

{/* @@ -213,13 +211,7 @@ export const HomePanel = () => {
-
-

Gallery

-

- Which gallery the carousel shows. Edit its contents in the Galleries section — every page - using it changes with it. -

-
+

Gallery

{/* A picker, not a list. diff --git a/web/sections/RecordsPanel.tsx b/web/sections/RecordsPanel.tsx index 7bbc1b6..86019f4 100644 --- a/web/sections/RecordsPanel.tsx +++ b/web/sections/RecordsPanel.tsx @@ -226,8 +226,6 @@ export const RecordsPanel = ({ config }: { config: RecordsConfig }) => { return (
-

{config.blurb}

- {/* The list, and the one field that makes another. A record is created with a title alone and filled in afterwards — asking for six fields before anything exists is a form nobody finishes. */} diff --git a/web/sections/records.ts b/web/sections/records.ts index 3d05d6f..4662297 100644 --- a/web/sections/records.ts +++ b/web/sections/records.ts @@ -38,8 +38,6 @@ export type RecordsConfig = { singular: string; /** What this section calls its title. Collabs say "Project name" and that is the client's word. */ titleLabel: string; - /** Shown once at the top, so a screen explains itself without a manual. */ - blurb: string; fields: FieldSpec[]; }; @@ -47,7 +45,6 @@ export const GALLERY_CONFIG: RecordsConfig = { path: '/fofos-admin/gallery', singular: 'piece', titleLabel: 'Title', - blurb: 'Standalone pieces, each with its own page and its own photographs.', fields: [ { key: 'descriptive_text', label: 'Description', long: true }, { key: 'measurement', label: 'Measurements', hint: '120 × 80 cm' }, @@ -62,7 +59,6 @@ export const DROPS_CONFIG: RecordsConfig = { path: '/fofos-admin/drops', singular: 'drop', titleLabel: 'Title', - blurb: 'Releases, in the order they should appear.', fields: [{ key: 'description', label: 'Description', long: true }], }; @@ -77,6 +73,5 @@ export const COLLABS_CONFIG: RecordsConfig = { path: '/fofos-admin/collabs', singular: 'collab', titleLabel: 'Project name', - blurb: 'Projects with other people.', fields: [{ key: 'project_description', label: 'Description', long: true }], };