<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta content="text/html;charset=UTF-8" http-equiv="Content-Type"></head><body ><div style="font-family: Verdana, Arial, Helvetica, sans-serif; font-size: 10pt;"><div>The Doc tools make it easy to edit and rearrange without having to work directly in the Help classes.<br></div><div><br></div><div><br></div><div>Here is the markdown for the terse guide, created from emacs.org mode using the org-md-export-to-md<br></div><div><br></div><div><a target="_blank" href="https://github.com/gettimothy/Doc-TerseGuide/blob/main/TerseGuideHelp.md">https://github.com/gettimothy/Doc-TerseGuide/blob/main/TerseGuideHelp.md</a><br></div><div><br></div><div><br></div><div><br></div><div>To modify, check out or fork the repo, then edit the TerseGuideHelp.org with a text editor.<br></div><div><br></div><div><br></div><div>Import that into the image using the <a target="_blank" href="https://github.com/gettimothy/Doc-DocToCustomHelpConverter/blob/main/DocOrgToCustomHelpConverter.md">https://github.com/gettimothy/Doc-DocToCustomHelpConverter/blob/main/DocOrgToCustomHelpConverter.md</a>  tools.<br></div><div><br></div><div>The repo is on squeak monticello . Xtreams is a requirement for the converters.<br></div><div><br></div><div><br></div><div>With this tool, documentation can exist in 5 places with less effort.<br></div><div>1. Help classes in the Help menu.<br></div><div>2. Monticello<br></div><div>3. Git<br></div><div>4. Your local file system<br></div><div>5. Served via Seaside as web help.<br></div><div><br></div><div><br></div><div>hth.<br></div><div><br></div><div>t</div><div><br></div><div><br></div><div><br></div><div class="zmail_extra_hr" style="border-top: 1px solid rgb(204, 204, 204); height: 0px; margin-top: 10px; margin-bottom: 10px; line-height: 0px;"><br></div><div class="zmail_extra" data-zbluepencil-ignore="true"><div><br></div><div id="Zm-_Id_-Sgn1">---- On Sun, 06 Feb 2022 10:16:42 -0500 <b> <mail@jaromir.net></b> wrote ----<br></div><div><br></div><blockquote style="margin: 0px;"><div>Hi Marcel, all,<br><br>I've noticed the Terse Guide is a bit outdated and contains some errors and inconsistencies. Would you be interested in a quick review of these?<br><br>To name a few:<br>1. Under General - Allowable characters name symbols like "blank" and "ff" which I guess are not being used any longer. It's also not clear what these symbols are supposed to be allowable for - variable declarations??<br>2. Under Constants - x := 2e-2 is it a fractional constant? Or a float constant? It's confusing what (1/50) is then :)<br>3. Under Method Call - missing declaration of anArray<br><br>I'm not sure why the Terse guide doesn't behave like a Workspace: I mean automatic declarations. It's not straightforward to print-it or inspect the examples line by line; for a beginner running them feels scary - if you select just the line you're interested in, it shouts unknown variable and if you accept, the modified Terse guide is half purple (in the Dark mode).<br><br>If you're interested I could also add a few more Exceptions examples.<br><br><br>best, <br>Jaromir<br>^[^ <br> --<br>Sent from Squeak Inbox Talk<br><br></div></blockquote></div><div><br></div></div><br></body></html>