Help:Howto/Update info when new version is released: Difference between revisions

From Miranda NG
Jump to navigation Jump to search
("Editing News page" outdated -> hidden)
 
(24 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__TOC__
__TOC__


== Version numbers ==
== Update version numbers ==
Update version numbers in [[Template:StableVersion]] (new stable build) and [[Template:CurrentVersion]] (next current/development version).
Update version numbers in {{Tl|StableVersion}} (new stable build) and {{Tl|DevelopmentVersion}} (next/development version).


== Update info about new stable release ==
In {{Tl|VersionInfo}} add entry for new stable. Provide its date and the rest of needed data. Use previous entries as example.


== Editing [[News]] page ==
== Update list of released stable versions ==
<spoiler show="outdated section" hide="collapse">
Add the new version to the list of released versions — {{Tl|StableVersionList}}. Use previous entries as example.
{{Message|message=These instructions are given using the English section as an example. To start updating info in other language, please use the language bar on the [[News]] page to switch to its corresponding version.}}
The News page consists of content transcluded from Changelog/* pages and is in its turn transcluded into Main Page. Thus it undergoes two types of changes:


=== Adding news ===
== Create Changelog/<new_version_number> page ==
To make an announcement about new version release you need to add a link to Changelog/<new_stable_version_No> page. The easiest way to do this is to make a copy of the previous entry and change the '''date''' and '''version number''' in it. Here's what a typical release announcement entry looks like:
When the above described is done, you'll see "Development version is <new_version_number>" at the top of [[Changelog]] page, where <new_version_number> is a red link to not existing page. To create that page, follow the link. As its content add code from the below and save page/changes:


<pre style="overflow:auto;">
<pre style="overflow:auto;">
{{News|title=New stable version is {{Version|en|0.94.6}}
<noinclude>{{PageLang|en}}{{VersionCard}}</noinclude>
|author=watcher
|date=2013-11-05
|content={{:Changelog/0.94.6}}
}}
</pre>
</pre>


This new entry should go first, i. e. right after the following code:
== Move new plugins to stable ==
Remove <tt>hide-stable=1</tt> parameter in {{Tl|PluginInfo}} for plugins that are being released as stable. This will add "stable" download links for those plugins on [[Download]] pages and in their plugin cards on their pages.


<pre style="overflow:auto;">
== Website ==
{{#switch: {{BASEPAGENAME}}
Update version numbers and links on all [https://miranda-ng.org/downloads/ "Downloads" pages]. Write the news.
  | Main pages
  | Main Page =
  | #default = {{Languages/News}}__NOTOC__
}}
</pre>


=== Hiding old news ===
All website pages are located in /var/www/miranda-ng.org/htdocs/content. For example /var/www/miranda-ng.org/htdocs/content/downloads/index.ru.md is a source for https://miranda-ng.org/ru/downloads/.
Old pieces of news can be hidden to prevent Main Page from being too long. This is obtained by moving the code


After editing, contact any member with superuser privileges (currently @dartraiden or @ghazan) to build the site:
<pre style="overflow:auto;">
<pre style="overflow:auto;">
{{#switch: {{BASEPAGENAME}}
sudo build-site
  | Main pages
  | Main Page =
  | #default = <!-- Please, move old news into this block (if there will be more than 3 news) -->
</pre>
</pre>


higher, so that 2 or 3 pieces of news are left between the top of the page and this switch.
== Forum ==
</spoiler>
Update banner on main page (click "Admin" then "Main" → "News and Newsletters"). Create and pin appropriate topics in "News" boards for English and Russian forums. Unpin previous topic.
 
 
== Creating Changelog/<new_version> ==
When the above described is done, you'll see the red link Changelog/<new_version> at the top of the News block on Main Page. To create the page, follow the link. Changelog/* pages have their own structure (pay attention to '''release date''' and '''version number'''):


<pre style="overflow:auto;">
== Github ==
<noinclude>{{VersionInfo
Update release notes: [https://github.com/miranda-ng/miranda-ng/releases realeases]
| en
| version=0.94.6
| released=5 November 2013
}}{{Languages/Changelogs|0.94.6}}</noinclude>
Short changelog:


* <changelog item>
== Jabber conferences ==
* <changelog item>
Update miranda-ng@conference.jabber.ru and miranda-ng-int@conference.jabber.ru topics.
* ...
</pre>


== Facebook group ==
Write news on our [https://facebook.com/miranda.newgen/ Facebook page]. This can be done by page adminis (apollo2k4 and dartaiden).


== Updating [[Changelog]] page ==
Add the new version to the list of released versions. Use previous entries as example.
[[Category:Howto]]
[[Category:Howto]]

Latest revision as of 21:41, 15 November 2023

Update version numbers

Update version numbers in {{StableVersion}} (new stable build) and {{DevelopmentVersion}} (next/development version).

Update info about new stable release

In {{VersionInfo}} add entry for new stable. Provide its date and the rest of needed data. Use previous entries as example.

Update list of released stable versions

Add the new version to the list of released versions — {{StableVersionList}}. Use previous entries as example.

Create Changelog/<new_version_number> page

When the above described is done, you'll see "Development version is <new_version_number>" at the top of Changelog page, where <new_version_number> is a red link to not existing page. To create that page, follow the link. As its content add code from the below and save page/changes: 

<noinclude>{{PageLang|en}}{{VersionCard}}</noinclude>

Move new plugins to stable

Remove hide-stable=1 parameter in {{PluginInfo}} for plugins that are being released as stable. This will add "stable" download links for those plugins on Download pages and in their plugin cards on their pages.

Website

Update version numbers and links on all "Downloads" pages. Write the news.

All website pages are located in /var/www/miranda-ng.org/htdocs/content. For example /var/www/miranda-ng.org/htdocs/content/downloads/index.ru.md is a source for https://miranda-ng.org/ru/downloads/.

After editing, contact any member with superuser privileges (currently @dartraiden or @ghazan) to build the site: 

sudo build-site

Forum

Update banner on main page (click "Admin" then "Main" → "News and Newsletters"). Create and pin appropriate topics in "News" boards for English and Russian forums. Unpin previous topic.

Github

Update release notes: realeases

Jabber conferences

Update miranda-ng@conference.jabber.ru and miranda-ng-int@conference.jabber.ru topics.

Facebook group

Write news on our Facebook page. This can be done by page adminis (apollo2k4 and dartaiden).

Retrieved from "https://wiki.miranda-ng.org/index.php?title=Help:Howto/Update_info_when_new_version_is_released&oldid=45163"