[squeak-dev] Help pages need your help

tim Rowledge tim at rowledge.org
Tue Dec 24 01:01:01 UTC 2019


It may be Feature Freeze time but it certainly isn't Help Page freeze. I've submitted some changes for a few of the  'The Project' pages but there are still lots needing improvement.

A few suggestions for things to write about - 
(general) clean up references to the various screen menus and TheWorldMenu and Dock menus and .... it's complicated. If you refer to mouse buttons please consider using the venerable Red/Yellow/Blue names instead of cmd-click etc - those are very machine specific. I added an explanation of red/yellow/blue to the 'Squeak User Interface' page.
Browser(s) - there's no help page for code browsers! We really could do with explanations of the system browser, the message browsers ( including the joy of the tracing browsers capabilities) hierarchy browser... pretty important tools.
Debugger - needs waaay more.
Tutorials->Command Key Mappings almost certainly needs checking and extending. And should it perhaps be moved  to the Tools section?
Core Packages->Commonly Used - Traits ? commonly used? Really? And at the very least the URL pointed to needs checking
Terse Guide - it would be smart tp run through all the sections and make sure everything works as expected. The underscore assign needs removing, as has already been mentioned today.

tim
--
tim Rowledge; tim at rowledge.org; http://www.rowledge.org/tim
Strange OpCodes: MD: Move and Drop bits




More information about the Squeak-dev mailing list