Fremantle
· OOUI · MediaWiki · programming ·
OOUI has a convention where parts of a class file are divided by comments such as /* Methods */ (e.g.). These are not method docblocks (they only have a single asterisk), and the phrases used are: Setup, Events, Static Properties (sometimes spelled with a lowercase 'P'), Static Methods, and Methods. I've not been working with OOUI much in the last year or so, but now am coming back to it, and it's weird but these comments are one thing that stick out to me more than other stuff. There's nothing wrong with them, but they feel like they're in the void that lies between the blocks of code and their docblocks, and it's a surprise to see anything there.
Comments on this post
No comments yet