[DOCS] Re: Squeak Documentation Project
Torge.Husfeldt at gmx.de
Torge.Husfeldt at gmx.de
Mon Feb 10 21:20:30 UTC 2003
"Lex Spoon" <lex at cc.gatech.edu> wrote:
> Doug Way <dway at riskmetrics.com> wrote:
>
> > * Definitely use the GaTech Squeak Swiki as a starting point, rather than a
> > separate swiki. There is quite a bit of documentation on the Swiki, while
> > sometimes disorganized, could be directly linked to from your pages. I see
> > that someone has already started by creating an "SDP" page on the Swiki, which
> > could be one starting point for discussion. (One thing I would change on that
> > page is to change the links at the bottom to things like *Basic Squeak
> > Development Tools* instead of *http://minnow.cc.gatech.edu/squeak/4*.)
>
> Also, on the front page there is a heading "Documentation", which has
> subheadings on major topics within Squeak. I was hoping this would be a
> table of contents for topics within Squeak, but people seem to overlook
> it. A notable example is the "Morphic" link undereath that subheading,
> which has loads of information about Morphic. We can always use more
> documentation, but I wish people would take try browsing from this
> location before giving up. It's as central as it gets aside from
> putting it right in the image.
>
>
> It also forms a great starting point for any *editor* who wants to go
> through and see what we have and what is missing. IMHO, we don't lack
> overall quantity and we don't lack effort. We *do* lack organization, both of
> existing material and of volunteer effort. We don't need a morphic
> tutorial, for example, but we still get a new one every few months. We
> *do* need a document on programming dialogue boxes in Morphic, but I
> don't think one exists.
>
> There is in existence a "Document Requests" page:
>
> http://minnow.cc.gatech.edu/squeak/1921
>
> On second thought, though, a better way to do this is to find the place
> underneath Documentation where a desired article should go, and then make a
> link to a new page on the topic. On the new page, just write "Someone
> write this, please".
Better yet, link to the 1921 "Document Requests" page so it can be
backtracked by the
'links to this page' feature.
Just my two cents,
Torge
>
>
> -Lex
More information about the Squeak-dev
mailing list
|