Format guidelines: Difference between revisions
Jump to navigation
Jump to search
(started new page) |
Ssmith2112 (talk | contribs) m (Fix typos) |
||
(One intermediate revision by one other user not shown) | |||
Line 1: | Line 1: | ||
* Accumulating material |
* Accumulating material |
||
* '''variable assignment syntax'''. Use <code>':='</code> instead of <code>'-'</code>. Ratios. I like |
* '''variable assignment syntax'''. Use <code>':='</code> instead of <code>'-'</code>. Ratios. I like <code>'_'</code> 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 <code>':='</code> is used more often, as far as I know. |
||
* '''Syntax |
* '''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 <u>Insert -> More -> Code Block</u>. |
||
* '''Typing in small code chunks (inlined code)'''. At the moment |
* '''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: <u>(1) select a code chunk (2) Click '''A''' -> Computer Code</u> . |
||
* ''' |
* '''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 |
Latest revision as of 13:51, 3 June 2025
- 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