[pmwiki-users] Re-thinking Intro to markup pages

Oliver Betz list_ob at gmx.net
Tue Feb 17 11:45:53 CST 2009


John Rankin wrote:

>I have created a draft Creole-based introduction page at:
>http://www.pmwiki.org/wiki/PmWikiCreole/EditingForNewcomers

[...]

>- adopt the widely-used design pattern that preformatted
>  text is displayed inside a padded box with dotted border,
>  often with a light grey background

people already might use preformatted text for a wide range of
applications, so the distribution should stay unchanged.

>It proved to be impossible to describe the Creole markup
>set using only the Creole markup set. I stretched this

Just my personal preference: I like the two column appearance (What to
type - What it looks like) in BasicEditing more. It is very clear and
IMO perfectly well suited to demonstrate markup.

As a beginner, I wouldn't dig into the sources if I get the
information presented readily.

BTW: Even the Creole pages use special markup to distinct markup from
result.

[...]

>The Creole documentation is inconsistent in a few places.

Of course. And the Creole pages don't explain the markup very well for
a beginner. They are made for the wiki developer, not for the user.

Therefore I'm afraid that a beginner misses a lot of essential
information in PmWikiCreole/EditingForNewcomers.

Oliver




More information about the pmwiki-users mailing list