TiddlyWiki5/editions/tw5.com/tiddlers/tips/TitlesPolicy.tid

created: 20130825103300000
modified: 20140122173818924
tags: tips
title: TitlesPolicy
type: text/vnd.tiddlywiki

As the structures within your TiddlyWiki documents get more complex it can be hard to keep the titles of tiddlers consistent. For example, should terms be defined in the plural or the singular? Camel case or separate words?

Recording a formal titling policy can help to reduce confusion. For example, the titling policies for this wiki are:

* Use lowercase single words for tags
** e.g. [[task]], [[demo]]
* Use CamelCase for definitions and concepts
** e.g. TiddlerFields, DeveloperDocs
* Use separate words for titles that are full phrases or sentences, such as FAQ, howtos or tasks
** e.g. [[How to build a TiddlyWiki5 from individual tiddlers]]
* Where TiddlyWiki or TiddlyWiki5 is used as a qualifier at the start of the title, always use separate words
** e.g. [[Saving with TiddlyFox]]

Policies that may make sense for your own wikis include:

* Use the prefix `$:/_` for any system tiddlers that you create to ensure that they are near the top of the system tiddler listing in the sidebar
Lotsa docs updates 2013-11-29 12:26:48 +00:00			`created: 20130825103300000`
Add note about system tiddler naming conventions 2014-01-23 08:23:49 +00:00			`modified: 20140122173818924`
Get rid of the 'docs' tag It was unnecessary, since everything here is documentation 2013-08-25 20:41:00 +00:00			`tags: tips`
Docs update Tearing up the recent changes tab... 2013-08-25 20:22:11 +00:00			`title: TitlesPolicy`
Lotsa docs updates 2013-11-29 12:26:48 +00:00			`type: text/vnd.tiddlywiki`
Docs update Tearing up the recent changes tab... 2013-08-25 20:22:11 +00:00
			`As the structures within your TiddlyWiki documents get more complex it can be hard to keep the titles of tiddlers consistent. For example, should terms be defined in the plural or the singular? Camel case or separate words?`

			`Recording a formal titling policy can help to reduce confusion. For example, the titling policies for this wiki are:`

			`* Use lowercase single words for tags`
			`** e.g. [[task]], [[demo]]`
			`* Use CamelCase for definitions and concepts`
			`** e.g. TiddlerFields, DeveloperDocs`
Add note about system tiddler naming conventions 2014-01-23 08:23:49 +00:00			`* Use separate words for titles that are full phrases or sentences, such as FAQ, howtos or tasks`
Docs update Tearing up the recent changes tab... 2013-08-25 20:22:11 +00:00			`** e.g. [[How to build a TiddlyWiki5 from individual tiddlers]]`
			`* Where TiddlyWiki or TiddlyWiki5 is used as a qualifier at the start of the title, always use separate words`
Lotsa docs updates 2013-11-29 12:26:48 +00:00			`** e.g. [[Saving with TiddlyFox]]`
Add note about system tiddler naming conventions 2014-01-23 08:23:49 +00:00
			`Policies that may make sense for your own wikis include:`

			* Use the prefix `$:/_` for any system tiddlers that you create to ensure that they are near the top of the system tiddler listing in the sidebar