[DOCS] RE: Wiki refactoring
Serge Stinckwich
Serge.Stinckwich at info.unicaen.fr
Wed Mar 5 12:29:41 UTC 2003
On Wed, 5 Mar 2003 01:09:16 -0500
Doug Way <dway at riskmetrics.com> wrote:
> >> As Stephen points out the swiki has something similar like the well
> >> known wiki "categories" pages. Actually each page acts as a category
> >> page because it has a drop-down menu which shows the pages which link
> >> to
> >> the page.
> >
> > As i say on the Wiki (http://minnow.cc.gatech.edu/squeak/2352), the
> > only problem i have with Swiki is
> > that there is no CapitalizedWords. I like them because they force you
> > to create meaningfull links, not like single word (like comment or
> > refactor).
> > Read this for a list of advantages of collapsed words :
> > http://c2.com/cgi/wiki?WikiNameAdvantages
>
> Well, Swiki still allows CapitalizedWords for wiki page names, it just
> doesn't enforce them. :-)
Yes you are right. No enforcement means, more prone to chaos ...
So we need good and well formalized conventions for writing in the swiki.
I start a page for that : http://minnow.cc.gatech.edu/squeak/3075
Please join and interact!
> I don't really buy the idea that enforcing CapitalizedWords is better.
> The Squeak Swiki has evolved a convention of not using
> CapitalizedWords, so I think we should probably stick with that.
I prefer CapitalizedWords because it's very Smalltalk related, but it's a question of taste :-)
In some wiki, you have an option to view CapitalizedWords with space, so it's more readable for newbies.
> I think allowing single word page names is actually a good thing. It
> allows the creation of "definition" pages for words like VM, image,
> MVC, Morph, Preference, etc., which can be used to create a more
> Encyclopedic Swiki.
>
> http://minnow.cc.gatech.edu/squeak/2348
>
> Also see http://c2.com/cgi/wiki?WikiNameDisadvantages ;-)
Yes, i already know this page, but i have the WikiNameInRealLifeSyndrome (http://www.c2.com/cgi/wiki?WikiNameInRealLifeSyndrome) !
> (Actually, I agree that "comment" is a bad example of a wiki page
> name... we should probably not have wiki pages devoted to method
> names... that's too low a level of detail, and prone to being made
> obsolete.)
>
> > I start to add several WikiTag
> > (http://minnow.cc.gatech.edu/squeak/3050). For example, put RecycleMe
> > on unused Swiki pages. when you start to create new
> > swiki pages, use one in the recycle bin.
>
> Actually, I don't mind your "RecycleMe" and "RefactorMe"
> CapitalizedWords for these pages. Using CapitalizedWords for these,
> indicates that these are special WikiTags, not regular pages, because
> the rest of the swiki does not use them. So that's good.
Yes, good idea. We can use this convention for specific tags.
> >> The problem at the moment is that categorization is not put to
> >> systematic use.
> >>
> >> If someone has a good idea of a categorization scheme please step
> >> forward.
> >>
> >> A least we have the color codes in the title section. And we have some
> >> good entry points into the net of interlinked pages.
> >
> > Yes, i know about the color codes, but you can't search colors
> > categories and the number of categories are fixed right now.
>
> I have to admit that I never notice the color codes and don't find them
> particularly useful. I've probably created a bunch of pages with the
> wrong color code. :-)
Can we upgrade the Squeak Swiki, to the last version of Swiki ? There is still the lame typo in the
search form (http://minnow.cc.gatech.edu/squeak/search) : senstitive
--
Serge Stinckwich -< ) multiagent.com
Université de Caen>CNRS UMR 6072>GREYC>MAD /~\ squeak.org
http://www.iutc3.unicaen.fr/serge/ (/ | zope.org
Smalltalkers do: [:it | All with: Class, (And love: it)] _|_/ debian.org
More information about the Squeak-dev
mailing list
|