The modern sdef dictionary format allows entries in the dictionary to be more extensive than previously. Besides a mere comment, dictionary authors can now include multiple formatted paragraphs of explanation.
You can toggle the display of extended explanatory material in the dictionary window’s info pane. To do so:
Script Debugger itself also provides some supplementary dictionary information that is “injected” into the dictionary display, such as the Description of the alias
datatype shown here. This supplementary information is instructional and can be especially helpful to AppleScript beginners.