2 Commits

Author SHA1 Message Date
9840180ba3 After the radius merge: Service Worker v24, and docs that said it could not be done
Service Worker v23 -> v24. The version was held back while the radius adjuster
lived on a branch, so reverting would not strand clients on a newer cache than
main. With the branch merged, deployed clients need the bump to pick up the new
bundle cleanly.

Four documentation passages said a finished circle could not be resized, which
was true when written and is not any more:

  Buffer / Circle guide
    - the call-out saying measurements are read-only
    - the call-out saying there is no box to type a radius into and the
      distance is set by eye
    - the troubleshooting row telling the reader to draw a new circle
  User manual, Part 1
    - the call-out saying to clear a measurement and draw it again

Three were found by searching for the phrases involved. The fourth only turned
up when the page was rendered and read, because it said the same thing in
different words — worth remembering the next time behaviour changes under
existing documentation.

Each correction keeps the point the original was making: the shape still cannot
be dragged out of true, so the figures always describe the circle on the map.
What changed is that there is now a deliberate way to resize it. The manual's
call-out stays accurate for areas, which still cannot be resized.

The guide also gains a paragraph where it describes the label, explaining the
minus, plus and typed entry and that the figures are ground distances; and two
quick-reference rows, for setting an exact radius and for dragging the analysis
panel out of the way. The manual's pointer to the guide no longer mentions the
radius-line handles, which no longer exist.

The manual is re-stamped as describing application version 24, September 2026.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 11:16:11 +02:00
4edb0a2f37 Add user manual Part 1; cross-reference the two tool guides
Part 1 covers the parts of the application that have been stable for months:
signing in and district scoping, the map screen, navigation, base maps, layers,
locations, measuring, an orientation to Analyse, exporting, working offline,
GPS, settings, and a troubleshooting table. Nine pages, built from the Analyse
tutorial so it matches the existing guides rather than looking like a new
document — same cover, header, footer, headings, call-outs and tables.

Held back deliberately: the drawing and digitising tools, which changed across
v15-v23 and want a settling period in the field, and anything depending on
server endpoints that are not deployed. Those are Parts 2 and 3. The manual is
stamped with the application version it describes (23), because an older
installation behaves differently around the toolbar.

Section 7.2 documents the Markers layer behaviour, including that switching it
off yourself will not stick, since that is the part most likely to look like
data loss.

On the two guides: I had said they were stale because they described the removed
Add Location button. That was wrong — neither mentions it, and I asserted it
without checking. What they did need was smaller. Both gain a Related documents
section so the three files read as a set, and the Analyse guide's manual-selection
instruction now says where the Select tool is, which it could not have when it
was written before the toolbar was banded into groups.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-08-21 10:28:07 +02:00