06-Sep-2026 — follow only the first GPX track, keep the author's paragraphs whole, and stop naming #388

build 879 — commit 1c8d5c3

What's new

The first author to check a generated guide against their own directions found the steps out of step with the text. This puts right the four causes they hit.

• One track. A GPX holding the route and a short cut as separate tracks was flattened into one line, so the guide said Finish where the first track ended and carried on through the second. The steps now follow one track, and a Route choice in the pill lets the reader pick which, with each track's length shown. The chosen track is drawn solid in the route colour and the others dashed in their own colours, the steps and distances follow the choice, it sits in the address, and the phone follows the same track. Short link sections are drawn but never offered as routes. Where a short cut leaves and rejoins the main route, the directions gain a fork card offering the short cut or the main route with their lengths; taking it redraws the route, adds lettered turns along the short cut, and the phone asks the same question as the walker approaches the fork.
• Introductions stay out of the steps. Paragraphs about parking and getting there, and the Distance and OS Map lines, are no longer hung on the first turns. They become the route's summary when it has none.
• Paragraphs stay whole. An author's paragraph attaches to the earliest step whose way or place it names, or to the next turn in the direction it opens with, skipping the turns the previous paragraph already covered. Sentences are no longer spread one at a time across turns.
• No footpath numbers. Definitive-map references such as SR47 are treated as unnamed, so the wording is "along the footpath", with the reference kept on the step for anyone who wants it.

At a glance

• Route choice for a GPX with more than one track: solid for the chosen, dashed alternatives, steps and phone follow the choice
• Short cuts found from the GPX; fork cards on the page and a fork prompt on the phone, with the choice carried as via in the address
• Introduction paragraphs become the summary; notes attach by paragraph, by place, way name or turn direction
• Reference-shaped way names are unnamed in the wording and kept as wayReference