Many documentation tiddlers, especially the reference ones, are concerned with a single concept. Their titles should be succinct noun phrases like List Widget
or Tiddler Fields
.
Each of the main words of such a title begins with a capital letter. Minor words such as "and", "or", "the", "to" and "with" do not.
Tags also follow this pattern.
Titles of this kind are plural if they denote a category of items, e.g. Keyboard Shortcuts
or Tiddler Fields
. Such titles are used to tag more specific tiddlers within the category.
Where a concept is an item rather than a category, its tiddler has a singular title, e.g. List Widget
, tag Operator
.
Start a title with its most distinctive part. For instance, the tiddlers documenting the filter operators have titles like addprefix Operator
. This helps the reader scan a list of links to find a particular tiddler.
Avoid starting a title with the word "the".
In the past, many tiddlers had CamelCase titles. This is gradually being phased out of the documentation to improve readability. CamelCase titles should no longer be used, even for tags, except in cases like JavaScript
where that is the standard spelling.
Instruction tiddlers often have longer titles that can be more complicated than just a noun phrase, e.g. Ten reasons to switch to TiddlyWiki
. These titles use sentence case, i.e. only the first word (and any proper names) starts with a capital letter.
How-to tiddlers have titles that begin with "How to", e.g. How to edit a tiddler
. Avoid titles like Editing tiddlers
, because a less fluent English speaker could misunderstand that as the name of a category of tiddlers.