Accessibility
Tiago Águeda edited this page 2026-11-11 16:15:37 +01:00

Page revisions

18 Commits

Author SHA1 Message Date
3fc93f2098
Describe saving a setting with no connection, and the script build
Accessibility says that a setting changed while Postulo cannot be reached is
kept and sent when the connection returns. Design and Installing Postulo say
that the page script is built from assets/js/app.js and committed, as the
stylesheet is.

Refs postulo/postulo#1157
Refs postulo/postulo#1149

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 16:15:37 +01:00
fc1e60b783
Accessibility: the underline setting covers navigation and board column names (postulo/postulo#843) 2026-10-27 23:53:08 +01:00
f71f01dd51
Phone navigation bar: holds every item and scrolls sideways, no More (postulo/postulo#912) 2026-10-27 23:53:08 +01:00
29f9b960f0
Your details: a question mark beside the heading and on every section, no helper text under headings
Refs postulo/postulo#918
2026-10-19 18:37:11 +02:00
8870f6fde9
Document the breadcrumb, the masthead search on Documents and the Calendar, the birth-date calendar and the sections menu
Refs postulo/postulo#831 postulo/postulo#832 postulo/postulo#848 postulo/postulo#851 postulo/postulo#863 postulo/postulo#870

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-11 19:33:36 +02:00
691c9d9ac6 Show the interface the pages describe, with pictures generated from a demo instance (#353)
Thirty-four pictures from scripts/screenshots.py in the postulo repository, each with alternative text, placed beside the text that describes it. Never retake one by hand: run the script.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-06 05:53:28 +02:00
84ee7beabe Document messaging handles, identifier order, Markdown listings, key caps and save-as-you-go
Writing a plugin names MessagingService, MessagingServicePlugin and messaging_service_of
and says the kind registers in postulo.messaging_services. Refs postulo/postulo#682 #672
#665 #658 #656 #333

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-05 18:57:07 +02:00
0c4e61405c
Career record, CVs, documents, Design, Accessibility: skills need a group, anonymous CV titles, the Documents menu, fieldsets
A skill needs a group and those without one are listed on the overview; deleting a career entry
removes its CV rows; a CV with contact details off does not name its holder in its title; the
four Documents lists have a section menu and Files filter by kind; a group of choices is a
fieldset with a legend; the Tags list is labelled with scripts off; switch knobs follow the
reading direction and a select's open list is painted from the same tokens in both themes;
Europass import strips markup, skips what the account holds and places entries by date; saved
views survive a width drag and can be named in any script.

Refs postulo/postulo#617 postulo/postulo#381 postulo/postulo#512 postulo/postulo#667
Refs postulo/postulo#624 postulo/postulo#625 postulo/postulo#518 postulo/postulo#517
Refs postulo/postulo#655 postulo/postulo#563 postulo/postulo#616 postulo/postulo#618
Refs postulo/postulo#632 postulo/postulo#503 postulo/postulo#504

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 12:04:58 +02:00
4360075460
Restoring: --allow-newer, the worker's profile in the container recipe; the export carries the accessibility choices
Refs postulo/postulo#479
Refs postulo/postulo#541
Refs postulo/postulo#464

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 03:14:48 +02:00
057f51076a
Say where the help is on Your details, and what it does for 1.4.13 and 3.3.2
Design: what a field's help is, the question mark on a card, and a section on help --
the tooltip, where it is drawn and when it is not, what stays in sight, the drawer, and
help as templates. Accessibility: what a person can expect of it and how it is tested.
A line pointing at each card's help topic where the wiki explains the same thing.

Refs postulo/postulo#302

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 06:33:51 +02:00
e8738ed35c
Say that each CV chooses which of your details it prints
A menu per kind on a CV's settings, the default following Your details
and a choice pinning a row; the form of address and pronouns printed
only where a CV says so; PATCH /cvs/{id} in the API; and what an archive
carries of the choice.

Refs postulo/postulo#308

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 19:48:56 +02:00
ee3e5df63e
Say that the header's box searches the page's table on three pages
On Companies, Applications and Listings the masthead's search narrows
the table, with a globe that searches everything; on a narrow screen it
is a bar under the masthead that never lies over what has focus; and the
live controls of a table take turns.

Refs postulo/postulo#313

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 16:05:19 +02:00
7b101053ac
Say how the main navigation keeps your order, and what it becomes on a phone
Getting started says the Appearance page orders the navigation as well
as trimming it, what the order decides (the row's room, the phone bar's
first four), and that on a phone the places are a bar at the foot of
the screen with More and search. It also stops saying "your name, top
right": the account menu has been your picture since #282.

Accessibility gains the navigation's promise (one list, one name, one
place in the reading order at every width; a row that never wraps; a
bar whose targets are 44 pixels and that nothing hides behind), the `/`
key on a narrow window, and what the navigation's own test measures
that axe cannot. Design gains *The main navigation*: one element drawn
once, how many items the row holds at each breakpoint and why, More,
the three neighbours that must know the bar's height and the rule about
containing blocks on the header, and what is stored for the order.

Refs postulo/postulo#299

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 15:31:26 +02:00
16d8883f1d
Say the underline on the current link is a choice
Refs postulo/postulo#289

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-20 11:29:43 +02:00
4fa72d9f15
Name the Accessibility settings section, and its address for the shortcuts switch
Refs postulo/postulo#281

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-19 13:28:04 +02:00
e2d5600ef2
The documents Postulo renders are tagged, and stop guessing
*Accessibility* listed untagged PDFs as a known gap, which they no longer are: a
CV, a portfolio, a letter and a report all come out as PDF/UA with a tag tree, so
the language they declare finally reaches a reader and the words come back in the
order they are meant to be read in. The page says so, says why PDF/A is
deliberately not claimed, and *CVs* points at it from the export step.

*Cover letters* gained a sixth placeholder, `{{ contact }}`, and two things the
page could not have described before: the application picker that opens a preview
reading the way the employer will read it, and the marker a placeholder with
nothing behind it shows instead of a blank, with the warning before freezing that
goes with it. The ordering step on *CVs* now describes what the arrows actually
do, which is move an entry past its neighbour.

*Your career record* had the Europass import promising a level for every
language. A file that states none now leaves the language without one, and the
language the file itself is written in is taken as the language of your career
record where you have not chosen one -- which is the setting that decides what
Postulo reports as untranslated.

Refs postulo/postulo#235

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-16 14:48:13 +02:00
27afa13bf6
Say that a single key can be switched off, and what focus now does
Accessibility said "focus is always visible", which was not true in a
high-contrast theme: the border and the ring Postulo drew focus with are
exactly what forced colours discards, so every field in the application
had no visible focus for anybody using one. It also did not mention that
three single keys do something, which is the sort of omission that leaves
somebody who dictates to their computer discovering `d` by losing a
listing to it.

So the page now says both, along with the two smaller promises the code
started keeping: that sorting, paging and switching theme leave focus where
you pressed, and that the first heading on a page is the page's own name.

Capturing postings and Getting started say where the switch is. Tracking
applications says that each board menu is named by its own application, and
that a status chosen with the keyboard is saved when the choosing stops
rather than at every status passed on the way -- which is a change in when
the card moves, and worth a sentence where somebody will read it. The
column handle reports its width now, so the line claiming the keyboard
works no longer leaves out that it used to do it silently.

Closes #227

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-16 14:38:03 +02:00
2d4c0c70de
Take the pages over from postulo/wiki, which this repository now replaces
Until now this was a copy of postulo/wiki, refreshed by postulo's
scripts/publish-wiki.sh whenever somebody remembered to run it. The last
time was 5 September (postulo@9645ee1). This brings it to postulo@b6cfb8f7:

- the four pages that never arrived: Accessibility, Hardening, Listings
  and Reports;
- the seventeen that had changed since;
- the images, which the script never copied because it copied *.md and
  nothing else, so Home has shown its logo and its Buy me a coffee button
  broken since the day they were added.

Nothing here was lost: every earlier commit is a publish, and the pages
they left matched postulo/wiki at 9645ee1 exactly.

From here pages are written in this repository and nowhere else.

Refs postulo/postulo#169

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-10 13:55:38 +02:00