Help:Updates: Difference between revisions

From the Portal Wiki
Jump to navigation Jump to search
(Created page with "Follow these instructions to update the relevant sections of the Wiki when there is an Update to any of the games, or the Portal blog. == Create a Patch page (Updates only) == =...")
 
mNo edit summary
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
Follow these instructions to update the relevant sections of the Wiki when there is an Update to any of the games, or the Portal blog.
{{NS HELP navbar}}


== Create a Patch page (Updates only) ==
=== Naming ===
Patch pages should be named according to the following rules:
* Portal 2:
** PC: <code>Month day, year Patch</code>
**:e.g. <code>January 1, 1970 Patch</code>
** PS3: <code>Month day, year Patch (PS3)</code>
**:e.g. <code>January 1, 1970 Patch (PS3)</code>
** Xbox: <code>Month day, year Patch (Xbox)</code>
**:e.g. <code>January 1, 1970 Patch (Xbox)</code>


* Portal:
This page documents the procedure for adding '''patch notes''' to the wiki. Patch notes now use the template {{tl|Patch layout}} to keep their layout consistent.
** PC: <code>Month day, year Patch (Portal)</code>
**:e.g. <code>January 1, 1970 Patch (Portal)</code>
** PS3: <code>Month day, year Patch (Portal PS3)</code>
**:e.g. <code>January 1, 1970 Patch (Portal PS3)</code>
** Xbox: <code>Month day, year Patch (Portal Xbox)</code>
**:e.g. <code>January 1, 1970 Patch (Portal Xbox)</code>


=== Patch page contents ===
== Instructions ==
#Copy and paste the following code:
=== Creating a new article ===
<ol>
<li>New patch articles should use the name format {{code|Month DD, YYYY Patch}}. If the patch is for the Xbox, append {{code|(Xbox)}} to the end. Examples:</li>
:{{code|January 1, 1970 Patch}} or {{code|January 1, 1970 Patch (Xbox)}}
<li>Copy and paste the following code:</li>
<pre style="margin-left:2.5em;"><nowiki>
<pre style="margin-left:2.5em;"><nowiki>
{{Patch layout
{{Patch layout
Line 34: Line 22:
}}
}}
</nowiki></pre>
</nowiki></pre>
*Copy and paste the patch notes ''directly'' from the article on http://store.steampowered.com/news/ and use the asterisk (<code>*</code>) to recreate the indents, for example:
<li>Copy and paste the patch notes ''directly'' from the article on http://store.steampowered.com/news/ and format them like this:</li>
<pre style="margin-left:2.5em;"><nowiki>
<pre style="margin-left:2.5em;"><nowiki>
* Fixed a bug where Portals were two-way.
* Fixed a bug where Portals were two-way.
Line 40: Line 28:
** Gave them work to do in an assembly plant instead.
** Gave them work to do in an assembly plant instead.
* Fired the guys who made ''those'' robots.
* Fired the guys who made ''those'' robots.
=== Community requests ===
* Added a new cvar
</nowiki></pre>
</nowiki></pre>
** If there are no patch notes, simply write: "Patch notes are unavailable at present".
<li>Add the URL of the update page to the {{code|source}} line at the top like this:</li>
*Add the URL of the update page to the {{code|source}} line at the top like this:
:{{code|1={{!}} source = http://store.steampowered.com/news/1234/}}
:{{code|1={{!}} source = http://store.steampowered.com/news/1234/}}
** As above, if patch notes have not been published, do not enter a url.
<li>Add the date of the previous patch to the {{code|before}} line like this:</li>
*Add the date of the previous patch to the {{code|before}} line like this:
:{{code|1={{!}} before = [[January 19, 2038 Patch]]}}
:{{code|1={{!}} before = [[January 19, 2038 Patch]]}}
*Add {{code|N/A}} to the {{code|after}} line.
<li>Add {{code|N/A}} to the {{code|after}} line.</li>
*Preview your article and if everything works fine hit '''Save page'''.
<li>Preview your article and if everything works fine hit '''Save page'''.
*On the previous patch page, adjust {{code|after}} to link to the new patch page.
 
** Preview and save this.
<h3 style="margin:0.5em -2.5em; margin-right:0;">Updating the rest of the wiki</h3>
 
<li>Go to [[Template:Updates]] and make sure {{code|patch-month}} and {{code|patch-day}} are all correct and up-to-date.</li>
<li>Go to the patch just before the new one and update its {{code|after}} line with a link to the latest patch:</li>
:{{code|1={{!}} after = N/A}} on the old patch article now becomes {{code|1={{!}} after = [[January 1, 1970 Patch]]}} (the date of the latest patch)
<li>Go to the article on [[Patches]] and add the latest patch as a new item to the top of the list.</li>
<li>You're done.</li>
</ol>


==== Advanced ====
=== Advanced ===
For complicated patch pages:
For more complicated patches.
* Handling two source links:
 
<pre style="margin-left:2.5em;"><nowiki>| source        = http://store.steampowered.com/news/1234/
* Handling two source links at once:
<pre style="margin-left:1.5em;"><nowiki>
| source        = http://store.steampowered.com/news/1234/
| source-title  = Part 1
| source-title  = Part 1
| source2      = http://store.steampowered.com/news/5678/
| source2      = http://store.steampowered.com/news/5678/
| source2-title = Part 2
| source2-title = Part 2
</nowiki></pre>
</nowiki></pre>
* Handing update pages (Using TF2.com examples, as the Portal series has never recieved major updates)
* Handing update pages (Using TF2.com examples, as the Portal series has never received major updates)
<pre style="margin-left:2.5em;"><nowiki>| update    = http://www.teamfortress.com/engineerupdate/
<pre style="margin-left:1.5em;"><nowiki>
| update    = http://www.teamfortress.com/engineerupdate/
| updatelink = The Engineer Update
| updatelink = The Engineer Update
</nowiki></pre>
</nowiki></pre>
**Handling update pages in different languages:
:* Handling update pages in different languages:
<pre style="margin-left:2.5em;"><nowiki>
<pre style="margin-left:2.5em;"><nowiki>
| update      = http://www.teamfortress.com/scoutupdate/german.htm
| update      = http://www.teamfortress.com/scoutupdate/german.htm
Line 71: Line 70:
</nowiki></pre>
</nowiki></pre>


 
[[Category:Help]]
 
== Update [[:Template:Updates]] ==
* TODO:  Implement platform-specific entries in Template:Updates
 
== Update [[Patches]] ==
* Ammend the [[Patches]] article to list the new patch.
** There are seperate sections for Portal and Portal 2 patches.  Use them correctly.
* Format the link to your patch page as: <code><nowiki>[[Patch article name|Month day, year]]</nowiki></code>
** For patches to specific platforms, append the Platform in brackets for the link text.  For example, <code><nowiki>[[Patch article name|Month day, year (PS3)]]</nowiki></code>
 
 
{{NS HELP navbar}}

Latest revision as of 13:24, 30 September 2021


This page documents the procedure for adding patch notes to the wiki. Patch notes now use the template {{Patch layout}} to keep their layout consistent.

Instructions

Creating a new article

  1. New patch articles should use the name format Month DD, YYYY Patch. If the patch is for the Xbox, append (Xbox) to the end. Examples:
  2. January 1, 1970 Patch or January 1, 1970 Patch (Xbox)
  3. Copy and paste the following code:
  4. {{Patch layout
    | source =
    | before =
    | after  =
    
    | notes  =
    
    ...
    
    }}
    
  5. Copy and paste the patch notes directly from the article on http://store.steampowered.com/news/ and format them like this:
  6. * Fixed a bug where Portals were two-way.
    * Fixed a bug where co-op robots had Portal guns.
    ** Gave them work to do in an assembly plant instead.
    * Fired the guys who made ''those'' robots.
    
    === Community requests ===
    * Added a new cvar
    
  7. Add the URL of the update page to the source line at the top like this:
  8. | source = http://store.steampowered.com/news/1234/
  9. Add the date of the previous patch to the before line like this:
  10. | before = [[January 19, 2038 Patch]]
  11. Add N/A to the after line.
  12. Preview your article and if everything works fine hit Save page.

    Updating the rest of the wiki

  13. Go to Template:Updates and make sure patch-month and patch-day are all correct and up-to-date.
  14. Go to the patch just before the new one and update its after line with a link to the latest patch:
  15. | after = N/A on the old patch article now becomes | after = [[January 1, 1970 Patch]] (the date of the latest patch)
  16. Go to the article on Patches and add the latest patch as a new item to the top of the list.
  17. You're done.

Advanced

For more complicated patches.

  • Handling two source links at once:
| source        = http://store.steampowered.com/news/1234/
| source-title  = Part 1
| source2       = http://store.steampowered.com/news/5678/
| source2-title = Part 2
  • Handing update pages (Using TF2.com examples, as the Portal series has never received major updates)
| update     = http://www.teamfortress.com/engineerupdate/
| updatelink = The Engineer Update
  • Handling update pages in different languages:
| update      = http://www.teamfortress.com/scoutupdate/german.htm
| updatelink  = Das Scout Update
| update-lang = de