head	1.4;
access;
symbols;
locks
	nobody:1.4; strict;
comment	@# @;


1.4
date	2003.01.18.09.22.32;	author PeterThoeny;	state Exp;
branches;
next	1.3;

1.3
date	2002.05.11.22.16.13;	author PeterThoeny;	state Exp;
branches;
next	1.2;

1.2
date	2001.01.30.23.51.33;	author PeterThoeny;	state Exp;
branches;
next	1.1;

1.1
date	2000.07.01.05.05.30;	author PeterThoeny;	state Exp;
branches;
next	;


desc
@none
@


1.4
log
@none
@
text
@%META:TOPICINFO{author="PeterThoeny" date="1042881752" format="1.0" version="1.4"}%
A <nop>WikiWord consists of two or more words with initial capitals, run together.

When you type a <nop>WikiWord, you establish a hyperlink. It's as easy as that.

<nop>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 <nop>WikiWord*

	* Uppercase letter(s)
	* Lowercase letter(s)
	* Uppercase letter(s)
	* Optional lowercase or uppercase letter(s) or number(s)

*Good examples for <nop>WikiWords:*

	* WikiWord
	* GoodStyle
	* AVeryLongWikiTopicNameIsAlsoPossible: wherever an uppercase or lowercase letter is allowed, a group of letters of the same case is allowed
	* YearTwoThousand

*Bad examples for <nop>WikiWords:*

	* Web: Name without the uppercase letter(s), lowercase letter(s), uppercase letter(s) sequence
	* T5Wiki: Name with number before the uppercase, lowercase, uppercase sequence
	* Md5sumsAfterBurning: Name with number before the uppercase, lowercase, uppercase sequence
	* Know-How: Name with dashes in between

*Hints*

	* Insert <nop>WikiWords wherever you can. Rich linking helps to make a Wiki successful.
	* Be specific. All topics in a web share one name space. For example, instead of =FunctionalSpec= write =BreadSlicerFunctionalSpec= because other projects might also have a functional spec topic.
	* %H% To stop a <nop>WikiWord from being turned into a hyperlink, insert the text =&lt;nop&gt;= immediately before the <nop>WikiWord.
	* It is recommended to create topics with singular names. Plural <nop>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 <nop>WikiName. Examples:
		* To create a topic about the the *Bread Slicer 1.2* product, use =BreadSlicer1dot2= or =BreadSlicer1pt2=, but not =BreadSlicer1.2=.
		* To create a topic about *year 2000*, you could go for =YearTwoK= or =YearTwoThousand=, but not =Year2K= or =Y2K= or =Y2000=.
	* Turn acronyms into <nop>WikiWords, i.e. take =FaqIndex= for a "FAQ index" topic.
	* You can specify any link label by using double square brackets, e.g. write =[<nop>[TWikiAccessControl][access control]]= to get a link to TWikiAccessControl that looks like [[TWikiAccessControl][access control]].
	* %X% The topic is assumed to be in the current TWiki web.  Prepending the name of a TWiki web and a period links to a topic in another web.

__Related Topics:__ WikiSyntax, TextFormattingRules
@


1.3
log
@none
@
text
@d1 1
a1 1
%META:TOPICINFO{author="PeterThoeny" date="1021155373" format="1.0" version="1.3"}%
d24 1
a24 1
	* AVeryLongWikiTopicNameIsAlsoPossible
d29 3
a31 2
	* Web: Name with no uppercase letter in between
	* T5Wiki: Name with number before the first lowercase letter
d38 2
a39 2
	* To stop a <nop>WikiWord from being turned into a hyperlink, insert the text =&lt;nop&gt;= immediately before the <nop>WikiWord.
	* A topic is usually presented in the singular. Plural <nop>WikiWords are automatically linked to the singular topic, i.e. the link WikiWords links to the topic WikiWord.
d45 1
@


1.2
log
@none
@
text
@d1 1
d36 1
d43 1
a43 1
	* You can create nicer looking links by using double square brackets, i.e. write =[<nop>[TWiki access control]]= to get a link to TWikiAccessControl that looks like [[TWiki access control]].
@


1.1
log
@none
@
text
@d10 1
a10 1
	* It avoids over-general topics, because at least two words are required
d24 1
a24 1
	* ProblemY2K
d37 7
a43 2
	* Sometimes you have to be creative to find a good <nop>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 <nop>WikiWords, i.e. take FaqIndex for a "FAQ index" topic.
@
