Several people have written papers about this, I believe I remember one at the 2015 KDAK Design Modeling Symposium and an earlier presentation at ACADIA.
Personally, I use color-coded groups to denote types of script elements ( Adjustable Variables, Import Components, Preview Components, ect. for fast navigation) This is paired with extensive naming of groups to describe in brief the operation occurring, and panel notes where needed. Below is an example that includes more annotation then usual for sharing with collaborators.
I also use a template with Personal or Professional Information in the top left, and some helper meta hopper scripts that allow for consistency in group colors and titles across all scripts
