[pmwiki-users] Fixing the documentation

Oliver Betz list_ob at gmx.net
Mon Jul 13 02:34:00 CDT 2009


Petko Yotov wrote:

[...]

>I also consider a feature being able to write [[(Pm )wiki]], [[(Wiki )styles]] 
>and [[(Wiki )trails]] when I link to PmWiki, WikiStyles or WikiTrails - it is 
>easier than [[WikiTrails|trails]].

I disagree regarding this feature. It's IMO hard to find and
understand for beginners, it saves only little typing and I can't
search link targets in the page source anymore.

I also dislike the feature that [[wiki sandbox]] links to
[[WikiSandbox]] because it "obfuscates" links in the page source and
people use it inconsistently.

Well, with the PmWiki search you can use link=WikiSandbox, but
consider a Cookbook page accessed by a wiki link from the Cookbook
group and by an interwiki link in the PmWiki group. There is no single
search expression finding all references to this page.

When I tried to explore the PmWiki documentation a long time ago, I
found many links written inconsistently making searching and
maintenance harder than necessary.

Oliver




More information about the pmwiki-users mailing list