Editing Module:Category series navigation/doc (section)

==About==
{{tl|Category series navigation}} is intended to be a minimal-input, near-universal template for automatically navigating ''most'' numerically adjacent categories.
{{Clear}}
{| class="wikitable"
|+ Recognized category types
! style="background: #CCCCCC;" | Type
! style="background: #CCCCCC; width: 25%;" | Example category
! style="background: #CCCCCC;" | BC(E)?
! style="background: #CCCCCC;" | Example output
|-
| Season || {{c|2001–02 FA Cup}} || No || {{Category series navigation|testcase=2001–02 FA Cup}}
|-
| TV season || {{c|Futurama season 1 episodes}} || – || {{Category series navigation|testcase=Futurama season 1 episodes}}
|-
| Office term (regular) || {{c|MEPs 2004–2009}} || No || {{Category series navigation|testcase=MEPs 2004–2009}}
|-
| Office term (irregular) || {{c|Wales AMs 2003–2007}} || No || {{Category series navigation|testcase=Wales AMs 2003–2007}}
|-
| Numerical range || {{c|Taxonbars with 30–34 taxon IDs}} || – || <!--{{Category series navigation|testcase=Taxonbars with 20–24 taxon IDs}}'s EPFC = 129-->
<templatestyles src="Module:Category series navigation/styles.css"></templatestyles><div class="categorySeriesNavigation" role="navigation" aria-label="Range">
<div class="toccolours categorySeriesNavigation-range">
<templatestyles src="Hlist/styles.css"></templatestyles><div class="hlist"><ul><li><span class="categorySeriesNavigation-item-inactive">15–19</span></li><li>[[:Category:Taxonbars with 20–24 taxon IDs|20–24]]</li><li>[[:Category:Taxonbars with 25–29 taxon IDs|25–29]]</li><li><b>30–34</b></li><li>[[:Category:Taxonbars with 35–39 taxon IDs|35–39]]</li><li>[[:Category:Taxonbars with 40–44 taxon IDs|40–44]]</li><li>[[:Category:Taxonbars with 45+ taxon IDs|45–49]]</li></ul></div>
</div>[[Category:Category series navigation range redirected (base change)]][[Category:Category series navigation range gaps]][[Category:Category series navigation range irregular]]
</div>
|-
| Decade || {{c|1990s in Scotland}} || BC || {{Category series navigation|testcase=1990s in Scotland}}
|-
| Year || {{c|1999 in Scotland}} || BC(E) || {{Category series navigation|testcase=1999 in Scotland}}
|-
| Year (auto-condensed) || {{c|Candidates in the 2000 United States presidential election|Candidates in the 2000 US presidential election}} || – || {{Category series navigation|testcase=Candidates in the 2000 United States presidential election}}
|-
| Year ({{para|skip-gaps|yes}}) || {{c|Amusement parks opened in 1877|skip-gaps=yes}} || – || {{Category series navigation|testcase=Amusement parks opened in 1877|skip-gaps=yes}}
|-
| Ordinal (temporal) || {{c|2nd-century rabbis}} || BC(E) || {{Category series navigation|testcase=2nd-century rabbis}}
|-
| Ordinal (numeric) || {{c|9th Lok Sabha}} || – || {{Category series navigation|testcase=9th Lok Sabha}}
|-
| Ordinal (word) || {{c|First Dynasty of Egypt}} || – || {{Category series navigation|testcase=First Dynasty of Egypt}}
|-
| Roman numeral || {{c|Deputies of Legislature X of the Kingdom of Italy}} || – || {{Category series navigation|testcase=Deputies of Legislature X of the Kingdom of Italy}}
|-
|colspan="4" style="background:#CCCCCC"|
|-
| Mixed decade || {{c|1760s in the Province of Quebec (1763–1791)}} || – || {{Category series navigation|testcase=1760s in the Province of Quebec (1763–1791)}}
|-
| Mixed year || {{c|1778 establishments in the Province of Quebec (1763–1791)}} || – || {{Category series navigation|testcase=1778 establishments in the Province of Quebec (1763–1791)}}
|}

===Searching behavior===
Most multi-year seasons/office terms/numerical ranges are acceptable, as long as the season duration/term length/range size is <= {{Category series navigation|show=term-limit}}, ''and'' the gap between seasons is <= {{Category series navigation|show=hgap-limit}}. For series exceeding either of these criteria, see/use {{tl|Irregular category series navigation}}.

The length of each season is automatically determined from the originating category name, up to and including {{Category series navigation|show=term-limit}} years. [[MOS:DATERANGE]] compliance is preferred, but some deviation is allowed and [[:Category:Category series navigation range abbreviated (MOS)|tracked]] for regular series with seasons > 1 year long. {{tl|Category redirect}}s are followed, and tracked for either [[:Category:Category series navigation range redirected (MOS)|MOS contravention]] (to be corrected) or for [[:Category:Category series navigation range redirected (base change)|navigational aid]] (no error). The gap size between successive seasons is ''also'' automatically determined, up to and including {{Category series navigation|show=hgap-limit}} years, and defaults to 0 (e.g. {{nowrap|1995–96}} → {{nowrap|1996–97}}).

Automatically condensed years are supported for ''presidential'' categories only (but can be easily expanded as needed), for gaps up to and including {{Category series navigation|show=ygap-limit}} years, and defaults to 1. To skip gaps of up to {{Category series navigation|show=skip-gaps}} years in any ''year'' categories, use {{para|skip-gaps|yes}}.

===Limitations===
====Numerical limitations and AD/BC/E====
* Season/office term categories do not work for ''any'' years BC, which will be hidden, because no working examples were found.
* Decade categories recognize BC, but not BCE, because no working examples were found.
* Ordinal & numeral words do not work above the ninety-ninth & ninety-nine, because no working examples were found.

====Condensation====
* Automatically condensed ''Olympics'' display is not supported due to peculiarities; use {{tl|Winter Olympics by year category navigation}}, etc., instead.
* Automatically condensed ''years'' ''are'' supported for ''US presidential'' categories only, due to their consistency; use {{para|skip-gaps|yes}} as desired on other ''year'' categories.
* {{para|skip-gaps|yes}} currently only works when starting on a ''year'' category, and is not intended to find all hyphenated ranges, which allows it to span much larger gaps.

====Work-arounds====
* '''Base-name changes:''' create at least 2 logically numbered {{tl|R from category navigation}} (1 [[Special:Permalink/1040103249|backward]] & 1 [[Special:Permalink/1040102736|forward]]), to join both related series.
* '''Unaccounted-for name+number conventions:''' where a fixed number is part of the prefix or suffix text, e.g. ''{{c|Companies that filed for Chapter 11 bankruptcy in 2020|Chapter 11 bankruptcies}}'', a non-breaking space may force the template to work. See [[Special:Diff/948223374|this fix]], where {{tl|title year}} skipped over ''11'' as part of a word rather than a discrete number. (This case has been accounted for and is no longer required in this example.)
* '''General:''' for large, permanent gaps<sup>†</sup> between successive categories, use {{tl|Preceding category}}, {{tl|Category pair}}, {{tl|Succeeding category}}, as needed, in addition to {{tl|Category series navigation}} on both sides, or in the middle, of the gap. Even if {{tl|Category series navigation}} is [[:Category:Category series navigation isolated|isolated]], it has the benefit of confirming the absence of nearby categories to the reader or maintainer.<br/><sup>†</sup>''Permanent gaps'', where there is a confirmed  permanent absence of data, and not just a temporary, yet to be filled, gap on Wikipedia.
* {{para|skip-gaps}}: create {{tl|R from category navigation}} from an appropriate year to the hyphenated category that was not found.

===Related CfDs===
* [[Wikipedia:Categories for discussion/Log/2019 June 8#Category:Northern Ireland MLAs 2016–17]]
* [[Wikipedia:Categories for discussion/Log/2019 May 29#Category:MEPs 1952–58]]
* [[Wikipedia:Categories for discussion/Log/2019 April 19#Category:Aircraft piston engines 1900–1909]]