[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