Actually for a slightly different POV… Some criteria for writing maintainable APL from my days at Sharp: a) Extracting only the comments should allow a competent APL’er to provide the missing code. b) No horrendous one-liners c) Code and comments may not exceed a single 8.5 x 11 sheet of paper.
> The reason is that you absolutely don't want to display “normal” comments as > documentation. FWIW
