I organise mine as in Gary's first example as I just find it easier to find things in the all the reams of code that way. I found keeping track of things a bit of a struggle at first and spent a lot of time scrolling up and down and trying to figure out what I'd done...but I'm a bit better at it now. I suppose some sort of GUI might come along at some point and make life easier?
Viewing post in What's the best way to organise your on_command{} handlers?
Are you using the search function?
Personally, I find it quite easy navigating with CONTROL + F, and searching for the concept I'm dealing with (e.g. river).
You can just keep tapping enter to cycle through matches, until you find the one (or ones) you are interested in.
I recently added a section to the document specifically to do with searching.
https://adventuron.io/documentation/#Searching
There is also the "Jump to section" functionality that is (somewhat hidden) behind the title of the text editor window.
Thanks for documenting this (very useful). The 'jump to' stuff will help hugely - I hadn't realised that it was there. As it is, I do use the search to find most things - more often that not, I remember some distinct word that I used in a message in the section that I need to get back to and search on that.