Logically structure your writing as a pyramid. Present information as it is needed. Your reader shouldn’t have to jump around your document, like they would for a piece of code.
I’d recommend structuring your code to not require jumping around either! E.g. group logic together in functions; put function and variable declarations close to where they are used; use the most local scope possible.
I’d recommend structuring your code to not require jumping around either! E.g. group logic together in functions; put function and variable declarations close to where they are used; use the most local scope possible.
good point!