Template:UpdatedBanner View history

m (Removed extraneous punctuation (assume the user will put a grammatically correct sentence in the description).)
(Allow otherSection parameter)
Line 4: Line 4:
| text =  
| text =  
{{#if:{{{majorDate|}}}|{{#ifexpr:{{#time:xNU|{{{majorDate}}} }}>{{#time:xNU|-6month}}|{{Anchor|UpdatedBanner-Major-current}}The contents of this page were substantially changed on '''''{{date|{{#if:{{{majorChurn|}}}|{{{majorChurn}}}|{{{majorDate}}} }} }}'''''. All editors '''must review''' this page thoroughly to understand the changes, which were for the following reason(s): [{{{majorForum}}} ''{{{majorDesc}}}'']{{Anchor|UpdatedBanner-Has-majorDate-check-subprimes}} {{#if:{{{majorChurn|}}}{{{otherDate|}}}|
{{#if:{{{majorDate|}}}|{{#ifexpr:{{#time:xNU|{{{majorDate}}} }}>{{#time:xNU|-6month}}|{{Anchor|UpdatedBanner-Major-current}}The contents of this page were substantially changed on '''''{{date|{{#if:{{{majorChurn|}}}|{{{majorChurn}}}|{{{majorDate}}} }} }}'''''. All editors '''must review''' this page thoroughly to understand the changes, which were for the following reason(s): [{{{majorForum}}} ''{{{majorDesc}}}'']{{Anchor|UpdatedBanner-Has-majorDate-check-subprimes}} {{#if:{{{majorChurn|}}}{{{otherDate|}}}|
<small><br/><br/>({{#if:{{{majorChurn|}}}|The overhaul first occurred on ''{{date|{{{majorDate}}} }}'' but related updates were made through {{date|{{{majorChurn}}} }}. |{{Anchor|UpdatedBanner-No-majorChurn}} }}{{#if:{{{otherDate|}}}| An [{{{otherForum}}} unrelated update] occurred on ''{{date|{{{otherDate}}} }}''|{{Anchor|UpdatedBanner-No-otherDate}} }})</small>|{{Anchor|UpdatedBanner-No-subprime}} }} |{{Anchor|UpdatedBanner-Major-expired}}<small>''This page was last revamped on {{date|{{{majorDate}}} }}{{#if:{{{otherDate|}}}|, and the last notable update was on {{date|{{{otherDate}}} }}}}. See discussion for possible links to related forum discussions.''</small>}}| {{Anchor|UpdatedBanner-No-majorDate(else)}} <small>''The last {{#if:{{{otherForum|}}}|[{{{otherForum}}} notable change]|notable change}} was on {{date|{{{otherDate}}} }}.''</small>}}
<small><br/><br/>({{#if:{{{majorChurn|}}}|The overhaul first occurred on ''{{date|{{{majorDate}}} }}'' but related updates were made through {{date|{{{majorChurn}}} }}. |{{Anchor|UpdatedBanner-No-majorChurn}} }}{{#if:{{{otherDate|}}}| An [{{{otherForum}}} unrelated update] {{#if:{{{otherSection|}}}|to [[#{{{otherSection}}}|{{{otherSection}}} }}occurred on ''{{date|{{{otherDate}}} }}''|{{Anchor|UpdatedBanner-No-otherDate}} }})</small>|{{Anchor|UpdatedBanner-No-subprime}} }} |{{Anchor|UpdatedBanner-Major-expired}}<small>''This page was last revamped on {{date|{{{majorDate}}} }}{{#if:{{{otherDate|}}}|, and the last notable update {{#if:{{{otherSection|}}}|(to [[#{{{otherSection}}}|{{{otherSection}}}) }}was on {{date|{{{otherDate}}} }}}}. See discussion for possible links to related forum discussions.''</small>}}| {{Anchor|UpdatedBanner-No-majorDate(else)}} <small>''The last {{#if:{{{otherForum|}}}|[{{{otherForum}}} notable change]|notable change}} was {{#if:{{{otherSection|}}}|to [[#{{{otherSection}}}|{{{otherSection}}} }}on {{date|{{{otherDate}}} }}.''</small>}}
}}
}}
<noinclude>{{Documentation}}</noinclude><includeonly>{{#if:{{{majorDate|}}}|[[Category:Major revision {{{majorDate}}}]]{{#if:{{{majorChurn|}}}|[[Category:Major revision {{{majorChurn}}}]]}}}}{{#if:{{{otherDate|}}}|[[Category:Notable revision {{{otherDate}}}]]}}</includeonly>
<noinclude>{{Documentation}}</noinclude><includeonly>{{#if:{{{majorDate|}}}|[[Category:Major revision {{{majorDate}}}]]{{#if:{{{majorChurn|}}}|[[Category:Major revision {{{majorChurn}}}]]}}}}{{#if:{{{otherDate|}}}|[[Category:Notable revision {{{otherDate}}}]]}}</includeonly>

Revision as of 03:32, 16 January 2015

{{mbox | type = notice | text = {{#if:|{{#ifexpr:Error: Invalid time.>1715595917|The contents of this page were substantially changed on {{{majorDate}}}. All editors must review this page thoroughly to understand the changes, which were for the following reason(s): [{{{majorForum}}} {{{majorDesc}}}] {{#if:|

({{#if:| An [{{{otherForum}}} unrelated update] {{#if:|to [[#{{{otherSection}}}|{{{otherSection}}} }}occurred on {{{otherDate}}}| }})
| }} |This page was last revamped on {{{majorDate}}}{{#if:|, and the last notable update {{#if:|(to [[#{{{otherSection}}}|{{{otherSection}}}) }}was on {{{otherDate}}}}}. See discussion for possible links to related forum discussions.}}| The last notable change was {{#if:|to [[#{{{otherSection}}}|{{{otherSection}}} }}on {{{otherDate}}}.}} }}

Documentation icon Template documentation[view] [edit] [history] [purge]

Usage example: {{UpdatedBanner |majorDate=2014/12/29 |majorChurn=2014/12/30 |majorDesc=Create a standardzied banner to date major policy page changes and similar items in the wiki. |majorForum=https://www.waze.com/forum/viewtopic.php?f=276&t=122654}} {{mbox | type = notice | text = {{#if:2014/12/29|{{#ifexpr:1419811200>1715595917|The contents of this page were substantially changed on 30 December 2014. All editors must review this page thoroughly to understand the changes, which were for the following reason(s): Create a standardzied banner to date major policy page changes and similar items in the wiki. {{#if:2014/12/30|

(The overhaul first occurred on 29 December 2014 but related updates were made through 30 December 2014.{{#if:| An [{{{otherForum}}} unrelated update] {{#if:|to [[#{{{otherSection}}}|{{{otherSection}}} }}occurred on {{{otherDate}}}| }})
| }} |This page was last revamped on 29 December 2014{{#if:|, and the last notable update {{#if:|(to [[#{{{otherSection}}}|{{{otherSection}}}) }}was on {{{otherDate}}}}}. See discussion for possible links to related forum discussions.}}| The last notable change was {{#if:|to [[#{{{otherSection}}}|{{{otherSection}}} }}on {{{otherDate}}}.}} }}

Displays a banner at the top of important pages ("must-reads"). The banner can be strongly worded semi-automatically for a period after major revision. Also supports important policy updates that are not at the level of major revisions, or many edits over time resulting from or resulting in a major revision.

Parameters:

  • majorDate = YYYY/MM/DD - date last major set of updates started (if there is still churn expected) or completed (if now stable)
  • majorDesc = description of the changes
  • majorForum = forum thread discussing the major changes
  • majorChurn = YYYY/MM/DD - a later update related to the recent major change
  • otherDate = YYYY/MM/DD - optional - last date of any significant change in content that is not considered major
  • otherForum = forum thread discussing any less significant changes




Four stratums of change are possible in the context of this template's banner:

  • Major: Page is completely overhauled, or many policy changes, or even a single policy change that has community-wide, "must know" implications. Should add/update the majorDate/majorDesc/majorForum, and remove otherDate. When expired (6 months) should be downgraded.
  • "Major churn:" There has been a recent major update, and the new change is smaller but corrects/clarifies the major update. Should only apply if the major update or subsequent similar "churn" was within the past two weeks. Change/add majorChurn but leave other parameters alone. Note that majorChurn should not be used for formatting, grammar, inconsequential updates, nor for any update not related to a recent major change.
  • Minor change: Inconsequential. Formatting, grammar, clarification to an item that is unlikely to have any significant impact if missed. Do not update the banner. You may wish to tick the "minor edit" box built into the wiki editing form.
  • Other: Any change to content that is important, but less critical, and does not alter the page as a whole. Update the otherDate and possibly otherForum, but nothing else. Note that if a change unrelated to a major overhaul occurs even the day after overhaul, then it is considered "other" not "churn."


Important note: "Major changes" semi-automatically "expire" after 6 months. If the page is not touched, it will continue to display the strong notification. However, the next time the page is saved after the 6 month mark, even if the UpdatedBanner template is not touched, it will automatically "sense" the expiration and change to a simpler, toned down message. The 6 month mark is set exclusively by majorDate, not majorChurn, so it is important to remove majorChurn and update majorDate once the churn period ends.


Some additional examples:

Call out intermediate level change to one section {{UpdatedBanner|otherDate=2005/3/21|otherForum=http://status.waze.com/|otherSection=Some Part}}

...results in...

{{mbox | type = notice | text = {{#if:|{{#ifexpr:Error: Invalid time.>1715595917|The contents of this page were substantially changed on {{{majorDate}}}. All editors must review this page thoroughly to understand the changes, which were for the following reason(s): [{{{majorForum}}} {{{majorDesc}}}] {{#if:2005/3/21|

({{#if:2005/3/21| An unrelated update {{#if:Some Part|to [[#Some Part|Some Part }}occurred on 21 March 2005| }})
| }} |This page was last revamped on {{{majorDate}}}{{#if:2005/3/21|, and the last notable update {{#if:Some Part|(to [[#Some Part|Some Part) }}was on 21 March 2005}}. See discussion for possible links to related forum discussions.}}| The last notable change was {{#if:Some Part|to [[#Some Part|Some Part }}on 21 March 2005.}} }}

Major change with unrelated intermediate change to one section {{UpdatedBanner |majorDate=2014/12/29 |majorChurn=2014/12/30 |majorDesc=Explanation of a significant change to editing policy within the document. |majorForum=https://www.waze.com/forum/viewtopic.php?f=276&t=122654|otherDate=2005/3/21|otherForum=http://status.waze.com/|otherSection=Some Part}}

...results in...

{{mbox | type = notice | text = {{#if:2014/12/29|{{#ifexpr:1419811200>1715595917|The contents of this page were substantially changed on 30 December 2014. All editors must review this page thoroughly to understand the changes, which were for the following reason(s): Explanation of a significant change to editing policy within the document. {{#if:2014/12/302005/3/21|

(The overhaul first occurred on 29 December 2014 but related updates were made through 30 December 2014.{{#if:2005/3/21| An unrelated update {{#if:Some Part|to [[#Some Part|Some Part }}occurred on 21 March 2005| }})
| }} |This page was last revamped on 29 December 2014{{#if:2005/3/21|, and the last notable update {{#if:Some Part|(to [[#Some Part|Some Part) }}was on 21 March 2005}}. See discussion for possible links to related forum discussions.}}| The last notable change was {{#if:Some Part|to [[#Some Part|Some Part }}on 21 March 2005.}} }}

Major change with unrelated intermediate change (no section info) {{UpdatedBanner |majorDate=2014/12/29 |majorChurn=2014/12/30 |majorDesc=Explanation of a significant change to editing policy within the document. |majorForum=https://www.waze.com/forum/viewtopic.php?f=276&t=122654|otherDate=2005/3/21|otherForum=http://status.waze.com/}}

...results in...

{{mbox | type = notice | text = {{#if:2014/12/29|{{#ifexpr:1419811200>1715595917|The contents of this page were substantially changed on 30 December 2014. All editors must review this page thoroughly to understand the changes, which were for the following reason(s): Explanation of a significant change to editing policy within the document. {{#if:2014/12/302005/3/21|

(The overhaul first occurred on 29 December 2014 but related updates were made through 30 December 2014.{{#if:2005/3/21| An unrelated update {{#if:|to [[#{{{otherSection}}}|{{{otherSection}}} }}occurred on 21 March 2005| }})
| }} |This page was last revamped on 29 December 2014{{#if:2005/3/21|, and the last notable update {{#if:|(to [[#{{{otherSection}}}|{{{otherSection}}}) }}was on 21 March 2005}}. See discussion for possible links to related forum discussions.}}| The last notable change was {{#if:|to [[#{{{otherSection}}}|{{{otherSection}}} }}on 21 March 2005.}} }}

The above documentation is transcluded from Template:UpdatedBanner/doc.
Please add categories to the /doc subpage.
Subpages of this template.