[squeak-dev] Documenting the system

Jakob Reschke jakres+squeak at gmail.com
Fri Jul 16 20:37:32 UTC 2021


Good idea with the poll.

Note that "Is the information accurate" might rather be a scale than a
boolean. Some information is accurate, other is probably out of date
or not reachable because of new key mappings etc.

Am Fr., 16. Juli 2021 um 22:27 Uhr schrieb Ron Teitelbaum <ron at usmedrec.com>:
>
> Thanks Tim.
>
> A few questions for everyone.  https://forms.gle/CsEpHvipoGbeud9k8
>
> If you have a minute please take a moment to answer this anonymous survey in google forms.
>
> Thank you!
>
> Ron
>
> On Fri, Jul 16, 2021 at 1:14 PM tim Rowledge <tim at rowledge.org> wrote:
>>
>>
>>
>> > On 2021-07-16, at 8:49 AM, Ron Teitelbaum <ron at usmedrec.com> wrote:
>> >
>> > Hello everyone,
>> >
>> > Hope everyone is doing well.
>> >
>> > How do we document Squeak?
>>
>> Don't forget the HelpBrowser. There are already some quite good pages in there and there should be a lot more. My suggestion would be that the HelpBrowser should include basic information and guides on how to use stuff - ie the sort of info that really doesn't fit well into class comment organisation - with pointers to more extensive doc on the Swiki.
>>
>> We *could* make it possible to load that Swiki info directly, or we could include the 'start up a web browser on this link' stuff from the ScratchPlugin.
>>
>> Obviously the key issue is getting people to write anything, anything at all, by way of documentation. It doesn't seem to be a popular hobby.
>>
>>
>> tim
>> --
>> tim Rowledge; tim at rowledge.org; http://www.rowledge.org/tim
>> USER ERROR: replace user and press any key to continue.
>>
>>
>>
>


More information about the Squeak-dev mailing list