Getting started
Tiago Águeda edited this page 2026-11-12 15:33:51 +01:00

Page revisions

32 Commits

Author SHA1 Message Date
366bcb4e44
Describe the moving mark and the pride month
Settings, Appearance now offers the mark beside the name still or
moving, and it stays still whenever the device asks for less motion.
In June the mark wears the pride colours, in the person's time zone.

Refs postulo/postulo#1238

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 15:33:51 +01:00
81387cfac2
Getting started: Connections is its own Settings item too
The " - " before it sat at the end of a line, so ef0a3e0 left it joined to
Account.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 15:31:53 +01:00
ef0a3e0661
Getting started: one line per item in the Settings list
Six of the seven sections (Accessibility to Your data) had run into the
Appearance item, joined by " - " in mid-line, so every renderer showed one
bullet. Translation follows paragraph by paragraph now (Weblate), and one
unit for the whole list was the wrong shape to translate.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 15:29:40 +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
44588f88ff
Form of address, pronouns and gender are stored as concepts and drawn in the page's or document's language
The profile API returns {key, label}; documents print the choice in their own language.

Refs postulo/postulo#921

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-19 19:57:15 +02:00
51254131ab
Calendar files leave notes and attendees out; photo metadata box; seed_demo password; capture links
Refs postulo/postulo#963
Refs postulo/postulo#964
Refs postulo/postulo#980
Refs postulo/postulo#962

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-19 00:01:04 +02:00
4805594ee9
Describe the gender words and the nationalities named as nationalities
Refs postulo/postulo#864 postulo/postulo#865

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-11 12:09:53 +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
ccf28f174c
Document the contribution rules, the personal details, the logo dialog, the intermediary role and social-profile usernames
Refs postulo/postulo#653 #654 #671 #674 #678 #679 #680 #681

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-05 15:02:03 +02:00
523b414923
Describe the phone search field in the header
Refs postulo/postulo#350

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 22:41:54 +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
fa46b79002
Give the way to Your career through the account menu
Refs postulo/postulo#676
2026-10-03 20:35: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
9bd0a9b41a
Say that every choice is a button with a list of its own
Design: Choices, the select every page draws, how it is used with the keyboard and what
it keeps from the native one. Tracking applications: a status on a card is saved when it
is chosen. Writing a plugin: a scheme's icon. Getting started: the time zones in groups.

Refs postulo/postulo#301
Refs postulo/postulo#315

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 05:20:30 +02:00
0cc2583605
Say how a postal address is checked against its country
Your career record: a section on the address rows -- what is refused, that a street is
never required and a town and a country are enough, how a postcode is put right, the
forces and territory forms, and that a stored or imported address is marked and left
alone. The same said shortly in Configuration, Getting started and Backups; the
address-line grid in Design; and in Writing a plugin, what postal-rules governs and
that a word shared with Postulo needs a context.

Refs postulo/postulo#306
Refs postulo/postulo#635
Refs postulo/postulo#458
Refs postulo/postulo#651

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 02:40:22 +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
d0545fa30c
Describe the form of address, the pronouns, the location rule and the profile calls
Your name gains two optional menus; a blank location prints the primary
address's town and country; the candidate file is format 3; the CV
importer leaves the location to the address; and the API has GET and
PATCH /profile, under read and write.

Refs postulo/postulo#309

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 14:40:44 +02:00
9aefad9b68
Move Reminders onto the Calendar page
A reminder is seen, made, changed and put off on the calendar; the
agenda narrowed to reminders is what the reminders page was, overdue
first, and the old address leads there.

Refs postulo/postulo#316

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-30 00:14:34 +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
7cd6bd1648
Deadlines, closing dates, and reminders that can be changed
The calendar draws four kinds of entry now and the key along the top is
also the filter; the diary file carries deadlines and closing dates as
all-day entries. A listing you are considering can tell you before it
closes, under Settings. A reminder can be put off, edited or deleted,
from its row and from the API — which is the first and only thing the
API deletes, so the scope table says which is which (#238).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-22 13:47:00 +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
56654488b8
Tracking applications, Getting started: Applications is one page in two shapes
Refs postulo/postulo#102

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-15 18:05:30 +02:00
b00c0a574d
Tracking applications, Getting started: the Calendar page
Refs postulo/postulo#204

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-15 17:20:58 +02:00
c653971c63
Getting started, Insights: Arrange edits the dashboard in place
Refs postulo/postulo#201

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-15 16:33:28 +02:00
eec3508ebd
Getting started: the theme switch is in the account menu
Refs postulo/postulo#197

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-15 14:56:04 +02:00
a9b6ec567e
Say that what Postulo ships is an administrator's to switch, and hidden on Settings → Plugins until asked
Refs postulo/postulo#200

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-15 13:33:57 +02:00
00506e0bb8
Say what Your details holds now, and that its parts are listed down the side
Getting started described the page as the contact block; it is the whole candidate record
now, with its parts navigable from the side.

Refs postulo/postulo#180

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-13 05:19:13 +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
64680b440f
Update wiki from postulo@ad6c142 2026-09-05 12:57:27 +02:00
ef61de01eb
Update wiki from postulo@036d3d3 2026-09-04 19:54:11 +02:00