This part of the wiki is intended to document the reasons behind choosing particular markup for [Creole], as well as to allow discussion of particular choices and propositions. These practices where derived from the [Goals] and the experiences Implementers and Users of Creole made.

[Creole] covers markup for some [CommonTextElements]. The markup should be [EasyToLearn] and [EasyToTeach], as well as [FastToType] and should use [ReadableMarkup] which is [NonDestructive].

The special role of common markup requires it to be [ExtensibleByOmission], [NotNew] and [CollisionFree] with markup used commonly on wikis.

The [InternationalizationConcerns] require it to [AvoidTextTags] and [AvoidSpecialCharacters].

Because we want [Creole] to be widely adopted, we need to make it easy to parse using [CommonWikiParsingTechniques], and also easy to explain, preferably using a prepared simple [CheatSheet]. In order to make it easy to explain, that means, intuitive, parser implementers might have to [MakeTheMachineWorkHarder].

There are [HintsOnExtending] that are supposed to help adding non-standard features to Creole when needed.
----

The only term for the markup page which is generally used is [Text Formatting Rules] across wikis (as shown on [[List of Wiki Markup]]), so I would suggest as a [GoodPractice] to have wiki markup explanation on this page on each wiki or to at have a redirect from that page to the page explaining markup.  A redirect would also be preferable if the wiki is not in English.  -- [ChuckSmith]