Format guidelines
Jump to navigation
Jump to search
- Accumulating material
- variable assignment syntax. Use
':='
instead of'-'
. Ratios. I like'_'
more, when it is rendered in Cuis XXX-SHOW-IT-UNICODE-XXX but there is a problem. (1) If we use the backward directed arrow the new user will be in trouble since he will not know how to type in that thing. (2) In other Smalltalks':='
is used more often, as far as I know. - Syntax highlighting in big code chunks. It is much easier to read. The automatic highlighter in Mediawiki does a good job. To insert code you need to do Insert -> More -> Code Block.
- Typing in small code chunks (inlined code). At the moment I haven't found a way to highlight inlined code. To type in inlined code for the moment do: (1) select a code chunk (2) Click A -> Computer Code .
- Mouse button name by left-right order. Always use the convention first, second, third button. The ordering is left to right. Mice are supposed to have 3 buttons. If people have strange mice (see Apple) they know already how to simulate the 3 buttons. Don't use the button color names as it is done in Squeak. As of today naming mouse buttons by color just adds to the complexity and perplexity of the new user.
- aaa