Raleighpedia:Style guide: Difference between revisions
FrankMuraca (talk | contribs) |
FrankMuraca (talk | contribs) Adding naming conventions for individuals |
||
| Line 31: | Line 31: | ||
== Naming conventions and capitalization == | == Naming conventions and capitalization == | ||
==== City vs. city | ===Individuals=== | ||
Editors should use commonly recognized names when naming articles, and if needed, note full or alternative names in the article introduction. | |||
* Mahatma Gandhi (not: Mohandas Karamchand Gandhi) | |||
* Bill Clinton (not: William Jefferson Clinton) | |||
* J. R. R. Tolkien (not: John Ronald Reuel Tolkien) | |||
''See: [https://en.wikipedia.org/wiki/Wikipedia:Article_titles#Use_commonly_recognizable_names Wikipedia:Article titles]'' | |||
=== City vs. city === | |||
Use '''“City of Raleigh”''' when referring to the municipal government as an organization or legal entity. | Use '''“City of Raleigh”''' when referring to the municipal government as an organization or legal entity. | ||
| Line 44: | Line 53: | ||
This convention follows common usage in municipal documents and helps avoid ambiguity. | This convention follows common usage in municipal documents and helps avoid ambiguity. | ||
=== Committees, boards, and policies === | |||
Use full, official names on first reference, with abbreviations if needed thereafter. | Use full, official names on first reference, with abbreviations if needed thereafter. | ||
| Line 60: | Line 69: | ||
* “the housing bond committee” when not referring to the formal name. | * “the housing bond committee” when not referring to the formal name. | ||
=== Dates and titles === | |||
Use specific dates where available. | Use specific dates where available. | ||
Latest revision as of 11:23, 1 February 2026
While Raleighpedia is designed to be a community resource, the content on the site should conform to a shared style. Unless otherwise specified below, use Wikipedia's style guide.
Citations
[edit source]Repeated references
[edit source]Raleighpedia favors clear, consistent citations over dense or repetitive footnoting.
When the same source supports multiple statements, editors should use named references and reuse them rather than repeating identical citations. This follows standard MediaWiki practice and improves readability.
Example:
<ref name="Meeting Minutes">...</ref>
Subsequent uses:
<ref name="Meeting Minutes" />
Citations should generally be placed at the paragraph level when a paragraph clearly summarizes a single source or document. Sentence-level citations are appropriate when multiple sources are used within the same paragraph or when precise attribution is required.
Citation templates
[edit source]Raleighpedia uses standardized citation templates to ensure consistency across articles. Templates such as Template:Cite minutes, Template:Cite govdoc, and Template:Cite web should be used wherever applicable.
Citation templates should be:
- defined centrally in the Template namespace;
- documented on their own template pages; and
- reused consistently across the site.
Editors should not create ad hoc citation formatting within articles. If an existing template does not fit a new source type, the preferred approach is to create or extend a template rather than formatting citations manually.
Naming conventions and capitalization
[edit source]Individuals
[edit source]Editors should use commonly recognized names when naming articles, and if needed, note full or alternative names in the article introduction.
- Mahatma Gandhi (not: Mohandas Karamchand Gandhi)
- Bill Clinton (not: William Jefferson Clinton)
- J. R. R. Tolkien (not: John Ronald Reuel Tolkien)
City vs. city
[edit source]Use “City of Raleigh” when referring to the municipal government as an organization or legal entity.
Example:
- “The City adopted the policy in 2015.”
Use “the city” (lowercase) when referring to Raleigh as a geographic place or community.
Example:
- “The policy applies throughout the city.”
This convention follows common usage in municipal documents and helps avoid ambiguity.
Committees, boards, and policies
[edit source]Use full, official names on first reference, with abbreviations if needed thereafter.
Example:
- “Affordable Housing Bond Advisory Committee (AHBAC)”
Capitalize the names of formally adopted policies, boards, and committees.
Example:
- “Affordable Housing Location Policy”
Do not capitalize informal or descriptive references.
Example:
- “the housing bond committee” when not referring to the formal name.
Dates and titles
[edit source]Use specific dates where available.
Example:
- “At the May 19, 2020 City Council meeting…”
Avoid relative phrasing such as “recently,” “at the time,” or “in the past.”
In article titles, put the year at the end in parentheses.
Example:
Tone and interpretation
[edit source]Raleighpedia articles should be descriptive rather than interpretive. Articles should document what occurred, when it occurred, and what decisions were made, using the language of the record wherever possible.
Avoid verbs or phrases that imply judgment or narrative framing, such as “marked a turning point,” “signaled a shift,” or “set the stage,” unless such language is explicitly used in a cited source.
Use of AI, citations, and naming conventions
[edit source]Use of AI-assisted writing
[edit source]Raleighpedia does not prohibit the use of AI tools to assist with research, drafting, or formatting. However, AI tools should be treated as writing assistants, not as sources or authors.
All content published on Raleighpedia is expected to meet the same standards regardless of how it was drafted. Content must be factually accurate, verifiable using reliable sources, neutral in tone, and grounded in documented records.
Editors are responsible for reviewing, editing, and verifying any AI-assisted text before publication. Unedited or lightly edited AI output should not be pasted directly into articles.
Editors may find Wikipedia’s guidance useful when evaluating AI-generated prose, particularly Signs of AI writing. Common issues include overly generic phrasing, vague summaries not tied to specific documents, fabricated or imprecise citations, and excessive repetition without documentary grounding.
Appropriate uses of AI tools include:
- summarizing long documents after they have been reviewed by the editor;
- drafting neutral descriptive prose from meeting minutes, reports, or memoranda;
- assisting with formatting tables, timelines, or citations; and
- checking consistency of names, dates, or terminology across an article.
AI tools should not be relied upon to:
- invent narrative structure not supported by sources;
- infer intent or motivation beyond what is stated in the record; or
- generate citations that have not been independently verified by the editor.