learnedax ([personal profile] learnedax) wrote2004-07-28 10:33 am

UnGood

You know, default WikiStyle really annoys me. Using it for most purposes results in forced intercapping, e.g. ManageMent, which is usually both ugly and confusing. But at least that can be avoided with [[bracketing stuff]], so you are not required (just highly encouraged) to use the WikiStandard of GoodStyle (which is a pretty 1984 way of putting it, anyway). The worse problem is that when it's used for things that are already intercapped, like ClassName, it automatically creates dead links for you. You often don't want to create a new WikiPage any time you mention an object or method, so you have to then specially mark it up to prevent parsing as a WikiLink.

I have now run into several cases of annoying kludges in both directions, which makes me wonder who thought this system made any GoodSense in the first place?
dsrtao: dsr as a LEGO minifig (Default)

[personal profile] dsrtao 2004-07-28 03:16 pm (UTC)(link)
First off, I've discovered that the people who both benefit from and take to a Wiki fastest are the just-competent users -- the ones who use computers as a tool, are willing to learn something to get their job done, but aren't interested in anything beyond that. To them, BiCap links are a hell of a lot more digestible than "create an URL and go edit that file".

Second, you (not you, but somebody) *do* want to have a WikiLink for each object or method. If you're putting code in your Wiki, it's for documentation purposes. (If you want source code repositories, CVS is over there and Subversion is over thataway...) A great way of documenting your code is to have it all hyperlinked to its descriptions.

[identity profile] en-ki.livejournal.com 2004-07-29 03:12 am (UTC)(link)
Yeah, pretty much the first thing I had to do when setting up a wiki was figure out how to bypass the stupid StudlyCaps=links rule. I was using kwiki, so I couldn't even do multiword links.

I really like how Everything2 does it (HTML without external references, internal references being []ed), but I wouldn't mind using a wiki that does [[]]s.