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

Kathryn Andersen kat_lists at katspace.homelinux.org
Wed Feb 18 05:40:19 CST 2009

On Wed, Feb 18, 2009 at 10:07:19AM +0100, Peter Bowers wrote:
[huge snip]
> Back on topic ... does the idea of 2 pages clarify things?   (Assuming it
> was implemented in a way that actually works.)  I'm thinking these pages
> won't get updated very often at all and so the potential issues of (1)
> keeping them in sync and (2) having two pages to update are probably pretty
> moot points...?

I dislike the idea of two pages because it makes it harder to maintain,
and it's hard enough to keep the pages up to date as it is (if it were
easy, we wouldn't be having this discussion about refactoring them in
the first place).

I also dislike the idea of forbidding the (:markup:) markup from the
BasicEditing page, or any other page.  As a user, I love the way the
PmWiki documentation shows examples of the markup and the result right
next to each other.  Examples make the use of the markup clearer, and
having them right there on the page makes it more convenient.  Looking
at another page and/or having to look at the source of the page is
decidedly INconvenient, IMNSHO.

I really haven't understood why using the (:markup:) markup is so
terrible.  Maybe I'm strange, but when I was first using PmWiki and
reading the documentation, I was reading the documentation, not looking
at the documentation source.  It didn't even occur to me to do so.
Thus I consider it very unlikely that beginners will be confused by the
(:markup:) markup.

Kathryn Andersen
 _--_|\     | Kathryn Andersen	<http://www.katspace.com>
/      \    | 
\_.--.*/    | GenFicCrit mailing list <http://www.katspace.com/gen_fic_crit/>
      v     | 
------------| Melbourne -> Victoria -> Australia -> Southern Hemisphere
Maranatha!  |	-> Earth -> Sol -> Milky Way Galaxy -> Universe

More information about the pmwiki-users mailing list