2 Commits

Author SHA1 Message Date
3ca6d72c98 Training exercises: illustrate the steps in topics 1 and 2
A peer review asked for pictures showing what a trainee should be seeing.
Fifteen figures added, each under the step it illustrates, with a caption.

Topic 1 (ten): the terminal after npm run dev; the application as it opens,
with the Distance button, the Settings arrow and the right-panel arrow
numbered; the dock with Distance off and on; the dock in dark mode; the
console session of exercise 3; the Settings panel with the Measurement
System switch; what fetch returns and the 200-with-HTML trap; the
click-to-screen chain; the distance label on the map; the Messages list.

Topic 2 (five): the three places a change can be; fast-forward versus a
merge commit; the conflict markers annotated; what .gitignore reaches and
what it does not; the sequence when a key is pushed.

The screenshots are captures of the application running from this source at
double resolution; the console figure is real output, which corrected a
mistake in the making — a module's exports list alphabetically, not in file
order, and the figure now says so.

Left out for now, to be added when someone can capture them: the developer
tools panels (Network, Elements, Sources at a breakpoint) and the Gitea
pages, neither of which can be photographed from here. The Analyse panel's
statistics list is also missing, since it needs district data from the
server.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-29 08:45:32 +02:00
ce6c922554 Status report: the Shapefile and startup fixes; training exercises for topics 1-3
Status report, section 18:
- 18.9 records that Shapefile export never worked — shp-write cannot run in
  this build — and what replaced it, including the check still outstanding:
  opening an exported file in QGIS or ArcGIS.
- 18.10 records the 428 kB that every visit downloaded although the
  application was built to avoid it, the two causes, and what a visit
  fetches now.
- Section 18 intro, Service Worker range v15-v26, Documentation and Open
  items renumbered, and a new open item for the desktop-GIS check.

Self-paced exercises for the first three topics of the Technician Training
Plan, on the LUPMIS2 template, each with answers:
- Topic 1 (6.1, web development foundations): seven exercises on the real
  application — the browser's view of it, its own modules in the console,
  tracing the Distance button from click to label, and one safe edit.
- Topic 2 (6.2, version control and secrets): eight exercises, from a first
  commit to a Gitea pull request, ending with a committed secret and the
  MinIO case. Every command was run in a scratch repository.
- Topic 3 (6.3, tooling, dialogs and reporting): six exercises ending in the
  hands-on task, a new dialog with a spreadsheet export; the solution given
  in the answers was built and run. Exercise 2 now finds the startup-loading
  defect through the history that fixed it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-23 14:09:12 +02:00