Skip to content

A front door organised by what the teacher came to do - #54

Merged
peopleworks merged 1 commit into
mainfrom
task-entry
Aug 10, 2026
Merged

A front door organised by what the teacher came to do#54
peopleworks merged 1 commit into
mainfrom
task-entry

Conversation

@peopleworks

Copy link
Copy Markdown
Owner

The first half of "make it friendlier for the teacher". No engine changes, no scoring changes, nothing that touches what the tool claims.

The diagnosis, which turned out not to be what I expected

I went in assuming the pages spoke the wrong language. They do not. The baseline page's own heading is already "¿Se parece a quien escribió los otros?", and originality opens with "¿Lo escribieron o lo copiaron?" — both exactly right, both written for a person with a stack of essays.

The navigation was hiding them behind the names of the engines. Analizar · Originalidad · Referencia · Catálogo · Carpeta is the index of the machinery. Nobody wakes up on a Monday wanting a baseline.

What changed

before after (ES) after (EN)
Analizar Un texto One text
Carpeta Una carpeta A folder
Referencia La misma persona The same person
Originalidad Coincidencias Overlap

Coincidencias over Originalidad is not just shorter: the page shows the passages two documents share and states outright that you judge. Calling it originality implies a verdict on originality that the tool refuses to give.

Plus a four-card band above the editor asking "¿Qué necesitas hacer?", ordered by how a teacher's week actually runs — the stack of submissions before the single text, because the single text is usually the second step of the same afternoon.

Two things that are the point, not the polish

  • The folder card stays in a browser — where scanning a folder is impossible — and says "en la aplicación de escritorio" before the click. Hiding it would leave a browser visitor believing the product cannot do this at all, which is the lowest-common-denominator answer HostCapabilities exists to avoid. Sending them to a page that explains why, with no warning on the card, is a small bait, and this project cannot afford small baits.
  • The current task is shown, not hidden. A chooser that omits where you already are makes the reader wonder what they missed.

What this deliberately is not

Friendlier must not mean more confident. There is no traffic light, no tick, no reassurance anywhere in this change — we spent the week removing exactly that from the report, the score card, the CLI and the empty state. The band routes and explains; every claim on the page is the one it already made.

Verification

  • Rendered, not just read — English and Spanish, both checked in a browser.
  • The grid measured at four container widths: 1 column at 390 and 430, 3 at 700, 4 at 900, no horizontal overflow at any, and none contributed by this band (measured A/B by removing it). An earlier headless screenshot appeared to show the page overflowing on a phone; that was the screenshot cropping below the layout width, not a defect.
  • 362 tests green; desktop solution builds (the UI is shared, and Folders.IsAvailable is true there, so the folder card links and drops the note).
  • The eight task keys are built from a list at run time, so a text search cannot see them and a deleted one would render as the raw key on the front door. Registered as computed keys — proved by deleting one and watching the locale guard fail.

Still open, from the same diagnosis

The second half is the result side: what the teacher does after the number appears. Not in this PR.

🤖 Generated with Claude Code

…t do them

The pages were never the problem. The baseline page's own heading is already
"Does this look like the person who wrote the others?" and the originality page
opens with "Did they write it or copy it?" — both in the reader's words. The
navigation hid every one of them behind the name of its machinery: Analyse,
Originality, Baseline, Catalogue, Folder. Nobody arrives wanting a baseline.
They arrive with thirty essays and one that felt wrong.

So the front door now asks what you need to do, and the navigation says it too:

  Analizar  → Un texto          Analyse     → One text
  Carpeta   → Una carpeta       Folder      → A folder
  Referencia→ La misma persona  Baseline    → The same person
  Originalidad → Coincidencias  Originality → Overlap

"Coincidencias" over "Originalidad" is not only shorter. The page shows the
passages two documents share and says outright that you judge; calling it
originality implies a verdict on originality that the tool refuses to give.

Four cards above the editor, in the order a teacher's week actually runs — the
stack of submissions before the single text, because the single text is usually
the second step of the same afternoon. Deliberately not a wizard and not a
filter: it routes and it explains, and the editor is still directly below, so
somebody who came to paste a paragraph loses one short band of page.

Two details that are the point rather than the polish:

- The folder card stays in a browser, where scanning a folder is impossible, and
  says "in the desktop app" **before** the click. Hiding it would leave a
  browser visitor believing the product cannot do this at all — the
  lowest-common-denominator answer HostCapabilities exists to avoid — and
  sending them to a page that explains why, with no warning on the card, is a
  small bait this project cannot afford.
- The current task is shown, not hidden. A chooser that omits where you already
  are makes the reader wonder what they missed.

And the tagline stops being a paragraph about live highlighting and states the
claim: we show you the evidence, not just a percentage. True for the teacher and
for the writer, which the old one was not.

Verified by rendering rather than by reading: English and Spanish, and the grid
measured at four widths — one column at 390 and 430, three at 700, four at 900,
no horizontal overflow at any of them, and none contributed by this band.

The eight task keys are built from a list at run time, so a text search cannot
see them and a deleted one would render as the raw key on the front door. They
are registered as computed keys, which the locale guard proved by failing when
one was removed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@peopleworks
peopleworks merged commit bce00a6 into main Aug 10, 2026
4 checks passed
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