Editing Template:S-start/doc (section)

===Simple boxes===
The very purpose of a succession box is to show the place of the ''subject'' of the box (the person—or other entity—whose article the box is in) in a succession of people (henceforth referred to as a ''succession chain''). Because of this, most boxes include three people, namely the subject, their predecessor, and their successor.

The quintessential succession box consists of three ''cells'', which go from left to right in the same order that the three persons' terms succeeded each other: the left cell names the predecessor, the middle one names the title of the subject and the years that mark their term in an office (the person's name is already mentioned in the article's title and is thus not repeated here), and the right one names the successor.

Simply enough, the creation of a box follows the same order. First comes the predecessor (template ''s-bef''), the title and years follow (template ''s-ttl''), and then comes the successor (template ''s-aft''). It should not be forgotten, of course, that every succession box opens with the ''s-start'' template, and ends with the ''s-end'' template. Each command should be given its own line in the edit box.

Have a look at this diagram.

:Enter the start field so that the program recognizes the table:
::<nowiki>{{s-start}}</nowiki>
:Enter the name of the predecessor:
::<nowiki>{{s-bef|before=[[</nowiki>''Enter predecessor here''<nowiki>]]}}</nowiki>
:Enter the title of the person on whose page you are working:
::<nowiki>{{s-ttl|title=[[</nowiki>''Enter title here''<nowiki>]]</nowiki>
:Also, enter the years during which they held that title (not necessarily in a different line):
::<nowiki>|years=</nowiki>''Enter start date here''<nowiki>&nbsp;– </nowiki>''Enter end date here''<nowiki>}}</nowiki>
:Enter the name of the successor:
::<nowiki>{{s-aft|after=[[</nowiki>''Enter successor here''<nowiki>]]}}</nowiki>
:Once everything is done, type:
::<nowiki>{{s-end}}</nowiki>


This is an example of the technique, taken from the article of [[Aegon IV Targaryen]]. Writing...

::<nowiki>{{s-start}}</nowiki>
::<nowiki>{{s-bef|before=[[Viserys II Targaryen|Viserys II]]}}</nowiki>
::<nowiki>{{s-ttl|title=[[King of the Andals, the Rhoynar, and the First Men]]<br>[[Lord of the Seven Kingdoms]]<br>[[Protector of the Realm]]</nowiki>
::<nowiki>|years={{Date|172|184}}}}</nowiki>
::<nowiki>{{s-aft|after=[[Daeron II Targaryen|Daeron II]]}}</nowiki>
::<nowiki>{{s-end}}</nowiki>

...will produce this:

{{s-start}}
{{s-bef|before=[[Viserys II Targaryen|Viserys II]]}}
{{s-ttl|title=[[King of the Andals, the Rhoynar, and the First Men]]<br>[[Lord of the Seven Kingdoms]]<br>[[Protector of the Realm]]
|years={{Date|172|184}}}}
{{s-aft|after=[[Daeron II Targaryen|Daeron II]]}}
{{s-end}}

Note that the names of the predecessor and the successor and the name of the title are enclosed within double square brackets; this allows for the names in the box to link to their respective articles. Although it is strongly suggested that you do link the names in the boxes even if they do not have their own article at the time (resulting in a red link), there can be exceptions.

It is encouraged that you include the title-holder's dates of term or reign whenever possible; if a date is dubious or disputed, use the ''s-ref'' template to include references that will back up that date (see the [[#S-ref|relevant section]] for details).