Hello, sorry for my absense lately...
Thanks for looking into the text's!
I have no problem whatsoever with you using what I have written and transforming it into something better. I think what you wrote in red makes perfectly sense, thanks! The text about the station signals would need to be updated to accommodate absolute block, though, but that should be easy.
After I created the initial helptext documents those years ago, I have been thinking back and forth how to best categorize the information in the text's. The current four (or five?) pages is not nearly enough to really describe all aspects of the signalling. An obvious way would be to categorize it by working methods, with the drawback that the amount of pages would drasticly increase (one page for each working method) as well as riscs of double information.
Alternatively it could be categorized by "signal-types", such like "choose signals", "station signals", "distant signals", and then describe how each of those signals works in each working method on their respective page.
Personally, I am leaning towards the "working method" categorization, though.
Also, the texts are lacking alot of information, simply because I didnt fully understand how all signals worked when I first wrote the pages. I mostly took James descriptions and wrote them out, mixing them with ingame observations. This, combined with new added signals (station signals and double block signals) along with changed functionallity, leads unfortunately to some fuzzy descriptions and inconsistent information. If I had written them today, they probably would have been much different

"In principle" I seem to remember being my wording, and it comes from the fact that I was told that it should work, but I for some reason could not get it to work, probably due to some bugs, and therefore that was the wording I came up with at the time.
You are right, it should be much more definite, to help the player understand the complex mechanism's across paksets.
Speaking of different paksets, the Swedish pakset currently has some signals which the British one doesnt, and that is the Absolute block station signal, Double block signal as well as the combination of the both. Also it has is_longblocksignal=1 on all track circuit signals so they all create directional reservations even for single faced signals.
Reading your OP inspired me to rethink the documents.
I would propose the following pages:
1 Signal overview:General points on how signals works, along with links to all of the other pages:
* Concept of how signals fundamentally differs from Simutrans Standard (Sighting distance; many needs signalboxes; no signal=drive by sight; etc)
* Concept of working methods
* Concept of signalboxes
* Concept of some of the major signal features (choose signals, permissive signals, distant signals, station signals etc)
* Concept of the different types of reservations a signal can make (currently only "red" and "blue").
* Concept of automatic signalupgrade.
* ...
2 Signal help:A help page where some of the most basic questions are answered:
* How do you build a signal
* How do you reassign a signal to a new signalbox
* How do you create a bidirectional signal (when possible)
* ...
3 Signalboxes:This page displays all details regarding signalboxes.
This page should also be the page that is displayed when clicking the question mark from a signalbox info window.
* Describe the specific signalbox features ("signals" and "radius")
* How to build signals using the signalbox
* How to check if a particular signal is connected to the signalbox
* How to see the radius of the signalbox marked on the ground
* How to reassign signals to a different signalbox
* ...
4 Signs:This page describes the different signs that can be placed along the railway.
5 Signal tips and tricks:Pretty self explanatory, this page would give the players some tips on how to optimize their signal layout.
* How to best space signals for maximum capacity on the tracks
* Best locations for signalboxes
* Brief summary on what signals and working methods would be best for different situations (and different eras). Examples could be:
* - Small mainline station
* - Single dead end
* - A line with only one track
* ...
And then a page for each working method, thoroughly describing each working method and patiently going through all the different kinds of signal variants that exists in each working method. Also some tips on where to put the signals and where not to put them.
6 Drive by sight
7 Time interval
8 Time interval with telegraph
9 One train staff
10 Token block
11 Absolute block
12 Track circuit block
13 Cab signalling
14 Moving blockAs far as I know there is no way to have pakset specific help texts, so the texts would have to be written to accomodate all variants, even if some pakset doesnt have a particular variant.
What do you think? What more would be needed/desired?