summaryrefslogtreecommitdiff
path: root/TWiki/WikiWord.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'TWiki/WikiWord.mdwn')
-rw-r--r--TWiki/WikiWord.mdwn38
1 files changed, 38 insertions, 0 deletions
diff --git a/TWiki/WikiWord.mdwn b/TWiki/WikiWord.mdwn
new file mode 100644
index 00000000..4457a568
--- /dev/null
+++ b/TWiki/WikiWord.mdwn
@@ -0,0 +1,38 @@
+A WikiWord consists of two or more words with initial capitals, run together.
+
+When you type a WikiWord, you establish a hyperlink. It's as easy as that.
+
+WikiWords are styled like this because:
+
+* It makes Wiki hyperlinks instantly recognizable
+* It leads to interesting Wiki topics
+* It avoids the need to fiddle with HTML tags
+* It avoids over-general topics, because at least two words are required
+
+**Syntax of a WikiWord**
+
+* Uppercase letter(s)
+* Lowercase letter(s)
+* Uppercase letter(s)
+* Optional lowercase or uppercase letter(s) or number(s)
+
+**Good examples for WikiWords:**
+
+* [[WikiWord]]
+* [[GoodStyle]]
+* [[AVeryLongWikiTopicNameIsAlsoPossible]]
+* [[ProblemY2K]]
+
+**Bad examples for WikiWords:**
+
+* Web: Name with no uppercase letter in between
+* T5Wiki: Name with number before the first lowercase letter
+* Know-How: Name with dashes in between
+
+**Hints**
+
+* Insert WikiWords wherever you can. Rich linking helps to make a Wiki successful.
+* To stop a WikiWord from being turned into a hyperlink, insert the text `<nop>` immediately before the WikiWord.
+* A topic is usually presented in the singular. Plural WikiWords are automatically linked to the singular topic, i.e. the link [[WikiWords]] links to the topic [[WikiWord]].
+* Sometimes you have to be creative to find a good WikiName. For example, if you want to create a topic about the year 2000 problem, you could go for [[FixY2K]] or [[YearTwoK]] or [[YearTwoThousand]], but not Year2K or Y2K or Y2000.
+* Turn acronyms into WikiWords, i.e. take [[FaqIndex]] for a "FAQ index" topic.