[pmwiki-users] BasicEditing - TextFormattingRules - MarkupMasterIndex refactoring
list_ob at gmx.net
Tue Feb 17 11:47:51 CST 2009
BasicEditing, TextFormattingRules and MarkupMasterIndex contain a lot
of redundant material and I'm looking for a clear(er) separation.
What would you say is the role of these pages?
In my opinion, MarkupMasterIndex is a fine "quick reference". No long
explanations, just examples. I'm tempted to change the introductory
BasicEditing is the starting point for the beginner, right?
TextFormattingRules claims to be a "more complete list". Should it
* repeat the contents of BasicEditing,
* or refer to them?
If TextFormattingRules repeated the basics (my preference), should it
be done using the same style? Currently the documentation style of
TextFormattingRules differs noticeable from BasicEditing.
With a uniform style, we could share a lot of text between both pages.
With TextFormattingRules as master document, BasicEditing could
(:include:) sections from TextFormattingRules.
Any reasons against this?
More information about the pmwiki-users