Library of Parliament:Manual of Style

From The Library of Parliament
Jump to: navigation, search

The Style Guide is the style manual for all Library of Parliament content. If any contradiction or conflict arises, this page always has precedence.

The Style Guide presents the Library of Parliament's house style, to help editors write articles with consistent and precise language, layout, and formatting, making the Library easier and more intuitive for users. Plain English works best. Avoid ambiguity, jargon, and vague or unnecessarily complex wording.

Style and formatting should be consistent within an article. Where more than one style is acceptable under this Guide, editors should not change an article from one of those styles to another without a good reason. Edit warring over optional styles is unacceptable.

Legislation

With a couple exceptions, the following is the generalized form all legislation infoboxes should take.

{{Infobox legislation
|enacted_by          = [[Open Parliament of the Social Liberal Union|Open Parliament]]
|short_title         = Amendment Y to ORIGINAL LEGISLATION
|citation            = CITATION
|bill_date           = DATE OF INTRODUCTION
|required_majority   = Simple majority/Two-thirds
|vote_begin          = DATE OF OPENING OF VOTING
|votes               = U Yea, V Nay, W Abstain<ref>FORUM DISCUSSION URL</ref>
|date_enacted        = DATE OF PASSAGE
|introduced_by       = [[AUTHOR]], [[AUTHOR/COSPONSOR]], [[AUTHOR/COSPONSOR]]
|status              = passed/in force/pending/not passed/repealed/spent/original
|amendments          = [[Amendment X to THIS LEGISLATION|CITATION]], [[Amendment Y to THIS LEGISLATION|CITATION]], [[Amendment Z to THIS LEGISLATION|CITATION]]
|before              = [[Amendment X to ORIGINAL LEGISLATION|Amendment X]]
|after               = [[Amendment Z to ORIGINAL LEGISLATION|Amendment Z]]
|original_text       = THIS LEGISLATION (Original)
}}

For citations, see the Third Constitution for passed legislation, or the Supplementary Organization of Laws Resolution for bills. Instead of |date_enacted=, dead bills upon which votes occurred should use |vote_end=. Generally, only Amendments use the before and after and short title parameters, and only amended Acts, Resolutions, and the Constitution use the amendments and original_text parameters. The following are appropriate uses of the status parameter:

  • passed: to be used for passed Resolutions and all passed forms of amendment (unless repealed or expired, which generally do not apply to amendments)
  • in force: to be used for passed Acts which have not been repealed or expired, the current Constitution, and effective treaties
  • pending: to be used for all legislation under consideration
  • not passed: to be used for dead legislation, whether a vote occurred or not
  • repealed: to be used for repealed legislation
  • spent: to be used for legislation which expired by its own mechanisms (like the SLU Modernization Act)
  • original: for original text pages only
Original text pages should use the following code directly after the infobox:
{{Original|Latest=MAIN LEGISLATION}}
The author of a long and/or highly technical piece of legislation may elect to use __NOTOC__ at this point to avoid a bad-looking table of contents displaying.

Let's take the World Assembly Membership Requirement Waiver Resolution as an example, as it includes the original_text and amendment parameters.

World Assembly Membership Requirement Waiver Resolution
CitationR-11
Enacted byOpen Parliament
Date enacted21 May 2017
Legislative history
Introduced on14 March 2017
Introduced byOdd Republic
Voting began16 May 2017
Required majoritySimple majority
Vote results5 Yea, 0 Nay, 0 Abstain
Amendments
Ra-1, Ra-2, Ra-3, Ra-4, Ra-5, Ra-6
Text as originally enacted
Status: Passed
{{Infobox legislation
|enacted_by=[[Open Parliament of the Social Liberal Union|Open Parliament]]
|citation=R-11
|bill_date=14 March 2017
|required_majority=Simple Majority
|vote_begin=16 May 2017
|votes=5 Yea, 0 Nay, 0 Abstain<!-- This is an example of a reference not being used, but new bills should have them. -->
|date_enacted=21 May 2017
|introduced_by=[[Ramelia]]
|status=passed
|amendments=[[Amendment 1 to the World Assembly Membership Requirement Waiver Resolution|Ra-1]], [[Amendment 2 to the World Assembly Membership Requirement Waiver Resolution|Ra-2]], [[Amendment 3 to the World Assembly Membership Requirement Waiver Resolution|Ra-3]], [[Amendment 4 to the World Assembly Membership Requirement Waiver Resolution|Ra-4]], [[Amendment 5 to the World Assembly Membership Requirement Waiver Resolution|Ra-5]], [[Amendment 6 to the World Assembly Membership Requirement Waiver Resolution|Ra-6]]
|original_text=World Assembly Membership Requirement Resolution (Original)
}}

Acts

Acts are without exception named in the format "XYZ Act".

Except in cases of peculiar anachronisms (such as pre-Third Constitutional formatting preserved in an Original Text document), Acts should appear in a form similar to what follows:

{{Infobox legislation
|many_lines_of_information
}}
__NOTOC__ or __TOC__ (per author choice; can appear before or after short description)
''Short description of functions of the Act (italicization is typical but up to author).''

== Article 1. Primary Function A ==
=== Section 1. Something Regarding Primary Function A ==
Text of this section.
::'''Clause 1.''' Additional information best expounded separately of the Section.
::'''Clause 2.''' More information best expounded separately of the section.

=== Section 2. Something Else Regarding Primary Function A ===
Text of the section.
::'''Clause 1.''' Clauses rarely appear standalone, but in this case it is warranted.

=== Section 3. Something More Regarding Primary Function A ===
Text of the section.

== Article 2. Primary Function B ==
=== Section 1. Something Regarding B ===
Text of the section.

=== Section 2. Something Else Regarding B ===
Text of the section; introduction of a list:
::'''Clause 1.''' List Item 1; and
::'''Clause 2.''' List Item 2; and
::'''Clause 3.''' List Item 3.

=== Section 3. Something More Regarding B ===
Text of the section, necessitating a list of a different form:
::'''Clause 1.''' List Item 1
::'''Clause 2.''' List Item 2

[[Category:Appropriate Category]]
And so on. Remember to use good judgement in determining which category an Act or bill for one belongs in, and note that original text documents use {{Original}}.

Act Amendments

Act Amendment titles are without exception to be phrased as "Amendment X to the Y Act".

Act Amendments should use essentially the format above for Acts. The most major difference is that Act Amendments are usually organized by sections without articles, but this is not always the case. Text substitutions, the most typical amendments made, should use a form approximately following this:

=== Section 3. Changing Something ===
Article 1, Section 2 of the SLU Modernization Act shall be amended to read as follows:
::New Text of Article 1, Section 2.
::::'''Clause 1.''' Text.
::::'''Clause 2.''' Text (if a section substituted has clauses, the author typically does not include them unless they are also substituted in some way).

or

=== Section 4. Changing Something Else ===
Article 5, Section 1, Clause 3 of the SLU Modernization Act shall be amended to read as follows:
::New Text. or ::'''Clause 3.''' New Text.

Additions should be phrased as approximately "(After) Article X, Section Y(, Clause W) of the Z Act, a Section/Clause/Article shall be inserted/appended to read as follows:". Removal of particular material should be phrased approximately as follows, with a renumbering clause at the end of the bill: "Article X, Section Y(, Clause W) of the Z Act shall be struck from the Act."{{Quote}} should not be used for legislation indentation.

Resolutions

Resolution titles are typically in the format "XYZ Resolution," but the form "On the XYZ" is sometimes used, especially for admission of Member States to Orders of Merit.

There are two basic formats in use for Resolutions. The first is essentially identical to that of Acts, and should be used as such (though Articles, in cases, are not used; in other cases, Sections may not be used and Articles may take a similar function). The second, and currently more popular, will be written as follows:

{{Infobox legislation
|several_lines_of_information
}}

'''WHEREAS''' something is such; and
'''WHEREAS''' something else is such; and
'''WHEREAS''' another thing is such;
'''NOW, THEREFORE, BE IT RESOLVED''' that some action a Resolution can take be taken/(where a list of things is warranted) that the following actions a Resolution can take be taken:
* Item 1
* Item 2
* Item 3

[[Category:Appropriate Category]]

Again, be careful in determining which category is correct. Further note that some forms of Resolution have a higher threshold for passage than typical of Resolutions.

Resolution Amendments

Resolution Amendment titles are to be phrased as "Amendment X to the Y Resolution/On the...Resolution". With resolution title beginning with "The," the form "Amendment X to The Y Resolution" is acceptable.

Resolution Amendments are most always phrased nearly as are Act Amendments, though of course they reference the pertinent Resolution, not Act.

Constitutional Amendments

Constitutional Amendment titles, for the duration of effectiveness of the Third Constitution are always to be phrased "Amendment X to the Third Constitution". Amendments to previous Constitutions are included under the documents themselves, but may be referenced without citation as "Amendment X to the First/Second Constitution."

Generally, Constitutional Amendments are written similarly to Act Amendments. They typically do not use Articles, and changes are entirely consistent of insertions, substitutions, and the striking of clauses/sections.

Historical Records

Election Records

Most all elections are to follow the naming system "OFFICE election, MONTH YEAR". For instance, an election for World Assembly Delegate election in July 2018 will take the name World Assembly Delegate election, July 2018. Ministerial elections, are similar, but are to follow the format "Ministerial elections, MONTH YEAR". A Ministerial election set in December 2018 would be called Ministerial elections, December 2018.

Infobox

All election records should have the following code, with appropriate values inserted (and adjusted for number of candidates standing) at the beginning of the page. <!-- 1 --> indicates the winner, <!-- 2 --> indicates the runner up, <!-- 3 --> third place, and so on until the candidates are exhausted. Correctly written inboxes will typically link to the next and previous elections. Start and end dates are of voting and do not include nominations—that information is in the election description. In approval elections, use |needed_votes = Majority of approval instead of what is written below, and set two candidates as Approve [[NATION]] and Reject [[NATION]], still putting first the option with the greatest number of votes.

{{Infobox election
|type                = presidential
|title               = SHORT NAME OF OFFICE("Speaker" and "Delegate", not "Speaker of the Union" and "World Assembly Delegate")
|election_date       = {{Start date|YYYY|MM|DD|df=y|p=y|br=yes}} - {{Start date|YYYY|MM|DD|df=y|p=y|br=yes}}
|before_election     = [[OFFICEHOLDER PRIOR TO ELECTION]]
|after_election      = [[NATION ELECTED]]
|election_name       = NAME OF OFFICE election, MONTH YEAR
|previous_election   = NAME OF OFFICE election, MONTH YEAR
|previous_year       = MONTH YEAR
|next_election       = NAME OF OFFICE election, MONTH YEAR
|next_year           = MONTH YEAR
|votes_for_election  = Member States eligible to vote
|needed_votes        = Majority of
|turnout             = NUMBER OF VOTERS voters ({{"decrease" or "increase" over previous election}}NUMBER of increase or decrease)
<!-- 1 -->
|image1              = [[File:WINNING CANDIDATE Flag.png/svg/jpg|150px]]
|candidate1          = '''[[WINNING CANDIDATE]]'''
|popular_vote1       = '''NUMBER'''
|percentage1         = '''WX.YZ%'''
<!-- 2 -->
|image2              = [[File:CANDIDATE Flag.png/svg/jpg|150px]]
|candidate2          = [[CANDIDATE]]
|popular_vote2       = NUMBER
|percentage2         = WX.YZ%
<!-- 3 -->
|image3              = [[File:CANDIDATE Flag.png/svg/jpg|150px]]
|candidate3          = [[CANDIDATE]]
|popular_vote3       = NUMBER
|percentage3         = WX.YZ%
<!-- 4 -->
|image4              = [[File:CANDIDATE Flag.png/svg/jpg|150px]]
|candidate4          = [[CANDIDATE]]
|popular_vote4       = NUMBER
|percentage4         = WX.YZ%
<!-- SEE BELOW INSTRUCTIONS IN CASE OF VOTE REDISTRIBUTION -->
}}

There are a couple of peculiarities to formatting Ministerial elections. First, you will use three infoboxes instead of one: for each of the ministries. The title is Minister of XYZ, and the election name should be Minister of XYZ election, MONTH YEAR, but previous and next elections are Ministerial elections, MONTH YEAR. Another exception created by Ministerials is the election of the second place candidate: because second place becomes Deputy Minister, ''italicize'' their name, votes, and percentage in the same manner the victors' are always '''bolded'''.

For an example of this infobox format, let's say an election occurred for Minister of Earth in January 2003 in which Anaaxes was victorious over Hirematia—if the pages "Minister of Earth election, January 2000" and "Minister of Earth Election, January 2006" existed, they would display as links at the top of the infobox.

Minister of Earth election, January 2003
← January 2000 1 January 2003 (2003-01-01) - 8 January 2003 (2003-01-08) January 2006 →

Member States eligible to vote
Majority of votes needed to win
Turnout6 voters (Decrease17)
  Anaaxes Flag.png Hirematia-Flag.svg
Candidate Anaaxes Hirematia
First preference votes 3 2
Percentage 60.00% 40.00%

Minister of Earth before election

Kanoria

Elected Minister of Earth

Anaaxes

{{Infobox election
|type=presidential
|title=Minister of Earth
|election_date={{Start date|2003|01|01|df=y|p=y|br=yes}} - {{Start date|2003|01|08|df=y|p=y|br=yes}}
|before_election=[[Kanoria]]
|after_election=[[Anaaxes]]
|election_name=Minister of Earth election, January 2003
|previous_election=Minister of Earth election, January 2000
|previous_year=January 2000
|next_election=Minister of Earth election, January 2006
|next_year=January 2006
| votes_for_election=Member States eligible to vote
| needed_votes=Majority of
| turnout=6 voters ({{decrease}}17)
<!-- 1 -->
|image1=[[File:Anaaxes Flag.png|150px]]
|candidate1='''[[Anaaxes]]'''
|popular_vote1='''3'''
|percentage1='''60.00%'''
<!-- 2 -->
|image2=[[File:Hirematia-Flag.svg|150px]]
|candidate2=[[Hirematia]]
|popular_vote2=2
|percentage2=40.00%
}}

For situations where votes must be redistributed, a special code is given after the candidates and before the closing curved brackets, as follows: (TO BE DETERMINED)

Description of Election and End Code

While there are many angles from which one can describe an election, the Library requires only that which is essential. You may go into further detail should you wish, but always include the following:

  • The opening and closing dates of nominations
  • The nations nominated
  • The nations who declared candidacies
  • The opening and closing dates of voting
  • The final first preference results, and description of redistribution or tie-break if applicable
  • A link to the nominations thread in references, if one exists
  • In Delegate elections when a new Constitutional Period is inaugurated by a Delegate transition, note as much and link the Constitutional Period

You are encouraged, but not required, to link to candidate's platforms, if any exist.

Append the following to each election code:

<references />
{{SLU Elections}}
[[Category:Elections]]

Historical Periods

Infobox

All Historical Period records should have the following code, with the appropriate values inserted, at the beginning of the page:

{{Infobox Historic Era
|name= DELEGATE Constitutional Period
|start= DD MONTH YYYY
|end= DD MONTH YYYY (or Present, if incumbent)
|image=DELEGATE Era.png
|delegate=[[DELEGATE]]
|before=[[PREDECESSOR Constitutional Period]]
|after=[[SUCCESSOR Constitutional Period]]
}}

For example, let's take a look at the Courellian Constitutional Period.

Courellian Constitutional Period
23 October 2017 – 15 July 2018
Courelli Era.png
Preceded byAusteren Constitutional Period
Followed byNorth American Republican Constitutional Period
DelegateCourelli
{{Infobox Historic Era
|name= Courellian Constitutional Period
|start= 23 October 2017
|end= 15 July 2018
|image=Courelli Era.png
|delegate=[[Courelli]]
|before=[[Austeren Constitutional Period]]
|after=[[North American Republican Constitutional Period]]
}}





Table

All Historical Period records should have the following code, with the appropriate values inserted, as the body of the page:

{|class="wikitable"
|+ The DELEGATE Administration
! Office
! Nation
! Term
|-
|-
|style="background:#cccccc;" align="center" colspan="4" |Executive Members
|-
|[[World Assembly Delegate]]
|[[DELEGATE]]
|style='border-style: solid solid solid solid;' |DD MONTH YYYY – DD MONTH YYYY
|-
!colspan=3|
|-
|[[Minister of Foreign Affairs]]
|[[NAME]]
|DD MONTH YYYY – DD MONTH YYYY
|-
!colspan=3|
|-
|[[Deputy Minister of Foreign Affairs]]
|[[NAME]]
|DD MONTH YYYY – DD MONTH YYYY
|-
!colspan=3|
|-
|[[Minister of Domestic Affairs]]
|[[NAME]]
|DD MONTH YYYY – DD MONTH YYYY
|-
!colspan=3|
|-
|[[Deputy Minister of Domestic Affairs]]
|[[NAME]]
|DD MONTH YYYY – DD MONTH YYYY
|-
!colspan=3|
|-
|[[Minister of Immigration]]
|[[NAME]]
|DD MONTH YYYY – DD MONTH YYYY
|-
!colspan=3|
|-
|[[Deputy Minister of Immigration]]
|[[NAME]]
|DD MONTH YYYY – DD MONTH YYYY
|-
|style="background:#cccccc;" align="center" colspan="4" |Independent Members
|-
|[[Founder of the Social Liberal Union]]
|[[Ainland]]
|DD MONTH YYYY – DD MONTH YYYY
|-
!colspan=3|
|-
|[[Speaker of the Union]]
|-
|[[NAME]]
|DD MONTH YYYY – DD MONTH YYYY
|}

Nation Profiles

Nation Profiles are the most customizable content medium for users of the Library, and, aside from a few required contents, are completely open for users to modify (their own page) as they please. Some users, such as Courelli, use their page as an in-character roleplay database about their nation, while other users, such as Omerica, use their page like a resume to display accomplishments.

Infobox

All Nation Pages share one fundamental aspect: the Nation Infobox. All Nation Pages should have the following code, with the appropriate values inserted, at the beginning of their Nation Page:

{{Infobox Officeholder
| name               = NAME
| image              = NAME Flag.png/jpg/svg
| image_size         = 150px
| founding_date = {{Start date and age|YEAR|MONTH|DAY|df=y|p=y|br=yes}}
}}

Furthermore, if the Nation in question has held government offices, the following code should be inserted, with the appropriate values inserted, into the above Infobox immediately following the "image_size" parameter:

| order1             = ORDINAL NUMBER
| office1            =  OFFICE
| term_start1        =  DD MONTH YYYY
| term_end1          =  DD MONTH YYYY
| predecessor1        = [[PREDECESSOR]]
| successor1          = [[SUCCESSOR]]
| delegate1 = [[DELEGATE]]

For Nations who have held more than one government office, simply duplicate the code above, and change the number in each line (for example, "office1"), increasing in number for each additional office added.

Categorization

Upon creation, and whenever updated, all content on the Library should be placed in the proper Category to ensure organization and accessibility.

To place a page into a Category, simply insert the code [[Category: ]] at the end of the content, with one of the following Category Names appearing after the colon:

  • Act Amendments‏‎
  • Acts of Parliament‏‎
  • Constitutional Amendments‏‎
  • Current and Past Constitutions
  • Dead Bills‏‎
  • Elections‏‎
  • Government Information
  • Nation Profiles‏‎
  • Original Legislation‏‎
  • Public Records‏‎
  • Regional History
  • Repealed Legislation
  • Resolution Amendments‏‎
  • Resolutions of Parliament‏‎
  • Submitted Bills‏‎
  • Treaties and interregional agreements‏‎

Other Provisions

Abbreviations

Write out both the full version and the abbreviation at first occurrence – as an example, The Combined Union Security Agency (CUSA)...

Dates

All dates are to be in the form of Day Month Year – as an example, "The SLU was founded 2 January 2011."