Nothing says which file a new HTTP handler belongs in #121

New Issue

2026-09-21T07:18:36Z

cgalo5758 commented

2026-09-21 07:18:36 +00:00

What a contributor runs into

The server package holds well over a hundred files and no stated layout. Fragment handlers, the ones that answer a partial request rather than render a page, are registered from five of those files: two named for partials and three that are page files. A contributor adding a fragment picks a file by imitation, and reviewers cannot tell from a path whether a route serves a page or a fragment.

Why it costs

Related handlers drift into different files, the same small helper gets written twice, and a change to one surface has to be hunted for across the package.

Where

internal/server.

Done when

The package states its layout in one place (page handlers, fragment handlers, the shared rendering helpers), the files match it, and a new route has one obvious home.

Migrated from status/issues.md at b7a0e15

## What a contributor runs into The server package holds well over a hundred files and no stated layout. Fragment handlers, the ones that answer a partial request rather than render a page, are registered from five of those files: two named for partials and three that are page files. A contributor adding a fragment picks a file by imitation, and reviewers cannot tell from a path whether a route serves a page or a fragment. ## Why it costs Related handlers drift into different files, the same small helper gets written twice, and a change to one surface has to be hunted for across the package. ## Where [`internal/server`](https://git.coopcloud.tech/wiki-cafe/member-console/src/commit/b7a0e15/internal/server). ## Done when The package states its layout in one place (page handlers, fragment handlers, the shared rendering helpers), the files match it, and a new route has one obvious home. Migrated from status/issues.md at b7a0e15

cgalo5758 added the

kind

debt

area/operator-ui area/member-ui labels 2026-09-21 07:18:36 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wiki-cafe/member-console#121