Differences

This shows you the differences between two versions of the page.

--- hub:tagging [2023/06/03 18:27] – davidpjonker
+++ hub:tagging [2023/06/07 17:32] (current) – elizabethherfel
@@ Line 5: / Line 5: @@
 <!-- NOTE: These links need to be modified so that the 'Tags' page does not get indexed for searching based on these tags -->
-<div #categories_box> Categories:  {{tag>2017_publication_year}} |  {{tag>2050_time_horizon}} |  {{tag>2050s_time_horizon}} |  {{tag>ageing}} |  {{tag>artificial_intelligence}} |  {{tag>climate_change}} |  {{tag>english_publication_language}} |  {{tag>genetic_engineering}} |  {{tag>global_geographic_scope}} |  {{tag>natural_resources}} |  {{tag>transportation}}   </div>
+<span #categories_box> Categories:  {{tag>2017_publication_year}} |  {{tag>2050_time_horizon}} |  {{tag>2050s_time_horizon}} |  {{tag>ageing}} |  {{tag>artificial_intelligence}} |  {{tag>climate_change}} |  {{tag>english_publication_language}} |  {{tag>genetic_engineering}} |  {{tag>global_geographic_scope}} |  {{tag>natural_resources}} |  {{tag>transportation}}   </span>
 \\
 A category page contains an introduction to the topic and links to pages that address that topic in more detail. A category page can be edited like an article and can the links to related pages can be automatically generated. Categories do not form a strict hierarchy since any page can be tagged for more than one category, and each category can appear in more than one higher level category. This allows multiple categorization schemes to co-exist within the Open Foresight Hub.
@@ Line 15: / Line 15: @@
 The Open Foresight Hub's category system does not automatically separate out pages found in the Encyclopedia, Library, and Futures sections. However, some category pages will organize the links to related pages and sub-categories by section.
-The start pages for the [[start|Open Foresight Hub]], [[encyclopedia:start|Encyclopedia]], [[library:start|Library]], [[futures:start|Futures]] and [[hub:start|Hub]] sections also contain links to high-level categories.
+The start pages for the [[:start|Open Foresight Hub]], [[encyclopedia:start|Encyclopedia]], [[library:start|Library]], [[futures:start|Futures]] and [[hub:start|Hub]] sections also contain links to high-level categories.
@@ Line 22: / Line 22: @@
 <!-- NOTE: These links need to be modified so that the 'Tags' page does not get indexed for searching based on these tags -->
-<div #categories_box> Categories:  {{tag>2017_publication_year}} |  {{tag>2050_time_horizon}} |  {{tag>2050s_time_horizon}} |  {{tag>ageing}} |  {{tag>artificial_intelligence}} |  {{tag>climate_change}} |  {{tag>english_publication_language}} |  {{tag>genetic_engineering}} |  {{tag>global_geographic_scope}} |  {{tag>natural_resources}} |  {{tag>transportation}}   </div>
+<span #categories_box> Categories:  {{tag>2017_publication_year}} |  {{tag>2050_time_horizon}} |  {{tag>2050s_time_horizon}} |  {{tag>ageing}} |  {{tag>artificial_intelligence}} |  {{tag>climate_change}} |  {{tag>english_publication_language}} |  {{tag>genetic_engineering}} |  {{tag>global_geographic_scope}} |  {{tag>natural_resources}} |  {{tag>transportation}}   </span>
-\\
 A tag is inserted into a page using the following Dokuwiki markup syntax: \\
@@ Line 38: / Line 37: @@
 =====Tag naming conventions=====
+Tags are most powerful when they concisely describe a topic while being broad enough that it will (eventually) describe more than one page in the Open Foresight Hub. A tag that will only ever describe one page is not useful.
-  * Standard article naming conventions apply; in particular, do not capitalize regular nouns except when they come at the beginning of the title.
+Before creating a new tag, editors should confirm that a similar tag does not already exist by reviewing the [[category:index_of_tags|index of tags]]. If none of the existing tags suffice then a new tag should be created using the following tag naming conventions.
-  * Names of topic categories should be singular, normally corresponding to the name of a Open Foresight Hub article. Examples: "Scenario Planning", "France", "Pierre Wack".
-  * Names of set categories should be plural. Examples: "Practitioners", "Facilitation tools".
+====General conventions====
-  * Avoid abbreviations. Example: "Category:Causal Layered Analysis", not "Category:CLA". However, abbreviations that have become the official or generally used name should be used where there are no other conflicts.
-  * Do not write the category structure in names. Example: "Urbanization", not "Drivers- Urbanization". This includes creating categories that are subpages of other categories.
+The following general conventions should be followed when naming any type of category tag:
+  * Standard page naming conventions apply; in particular, do not capitalize regular nouns except when they come at the beginning of the title.
+  * Names of topic categories should be singular, normally corresponding to the name of a Open Foresight Hub page. Examples: "Scenario Planning", "France", "Pierre Wack".
+  * Names of category sets should be plural. Examples: "Practitioners", "Facilitation tools".
+  * Avoid abbreviations. Example: "Causal Layered Analysis", not "CLA". However, abbreviations that have become the official or generally used name should be used where there are no other conflicts.
+  * Do not write the category structure in names. Example: "Urbanization", not "Drivers-Urbanization". This includes creating categories that are subpages of other categories.
   * Choose category names that can stand alone, independent of the way a category is connected to other categories. Example: "Geography terminology stubs", not "Terminology" (a subcategory of "Geography stubs").
-  * Avoid descriptive adjectives such as famous, important, or notable in category titles.
+  * Avoid descriptive adjectives such as 'famous', 'important', or 'notable' in category titles.
-  * Particularly for technical subjects, use words and phrases which exist in reliable sources, so that those sources may be used to support inclusion of articles.
+  * Use words and phrases which exist in reliable sources so that those sources may be used to support the inclusion of articles. This is especially important for technical topics.
 ====Special conventions====
-When categorizing based on date, it is important to distinguish whether an article is discussing past and present events, or speculating about possible futures. Example: "2020 time horizon" "2020 publication year" "2020 events"
+===Dates===
+The tagging of dates is primarily focused on years, decades, and optionally centuries. The following naming conventions are used. Specifically, a year is a 4-digit number i.e. 2023.
+A decade represents the years between year 0 and year 9 of that decade. For example, 2030s represents 2030-2039. When tagging, a decade is a 4-digit number ending in a zero and followed by the letter 's':
+<span #example_box>{{tag>2030s 2040s 2050s}}</span>
+A century represents the years between year 0 and year 99 of that century. For example, 2100c represents 2100-2199. When tagging, a decade is a 4-digit number ending in two zeros and followed by the letter 'c':
+<span #example_box>{{tag>2000c 2100c 2200c}}</span>
+A millennium represents the years between year 0 and year 999 of that millennium. For example, 2000m represents 2000-2999. When tagging, a millennium is a 4-digit number ending in three zeros and followed by the letter 'm':
+<span #example_box>{{tag>2000m 3000m 4000m}}</span>
+For extra clarity, the following conventions are used to distinguish a date between the year, decade, century, and millennium:
+<span #example_box>
+  = the year 2000 \\
+s = the decade spanning 2000 - 2009 \\
+c = the century spanning 2000 - 2099 \\
+m = the millennium spanning 2000 - 2999
+</span>
+==Time horizons==
+Many entries in the Library, Futures, and Encyclopedia refer to specific future (or past) time horizons. The convention for tagging a time horizon is to specify the date followed by '_time_horizon'. The following are examples of year, decade, and century time horizon tags:
+<span #example_box>
+Year: 2000_time_horizon \\
+Decade: 2000s_time_horizon \\
+Century: 2000c_time_horizon
+</span>
+==Publication year==
+Where possible tagging the publication year of library entries can assist people research futures perspectives within a given time period. The convention for tagging a publication year is to specify the date followed by '_publication_year'. The following is an example of a publication year:
+<span #example_box>2000_publication_year</span>
+===Political Geography===
+The categorization of content by political geography follows the United Nations geoscheme, which groups countries or political areas into regions, sub-regions, intermediate regions. The naming conventions and groupings can be found on the following Wikipedia page that [[https://en.wikipedia.org/wiki/List_of_countries_by_the_United_Nations_geoscheme|lists countries by UN geoscheme]].
+To tag a city, county, state, province, or other sub-region within a country follow the standard convention for that specific country.
+==Geographic Scope==
+Many entries in the Library, Futures, and Encyclopedia have a specific geographic scope. To specify that a geographic scope append "_geographic_scope" to the name of the specific political geography. For example:
+<span #example_box>Africa_geographic_scope United_States_geographic_scope</span>
+===Languages===
+While the Open Foresight Hub is currently only published in English, entries in the Library are NOT limited to the English language. Languages are to follow the ISO language name standard. The most common languages can be found on Wikipedia's [[https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes|list of ISO 639-1 codes]].
+==Publication language==
+To specify the publication language for a library entry append "_publication_language" to the name of the ISO language name. For example:
+<span #example_box>English_publication_language</span>
 =====How to make category pages=====