(document the magic) |
(document new fifth parameter (for specifying source release)) |
||
| Line 12: | Line 12: | ||
If the ''fourth'' parameter is set to {{code|encrypt}}, the test case will be for upgrading an encrypted system; e.g. {{code|<nowiki>{{Testcase upgrade|workstation|||encrypt}}</nowiki>}} to get a test case which covers upgrading an encrypted Workstation install. | If the ''fourth'' parameter is set to {{code|encrypt}}, the test case will be for upgrading an encrypted system; e.g. {{code|<nowiki>{{Testcase upgrade|workstation|||encrypt}}</nowiki>}} to get a test case which covers upgrading an encrypted Workstation install. | ||
The ''fifth'' parameter can be used to specify the release the test case tests upgrading ''from''. Its value is passed to [[Template:FedoraVersion]] as its second parameter, for the two places where that template is used to specify the source release. If not set, the source release will be the current stable release. For e.g. {{code|<nowiki>{{Testcase upgrade|||||previous}}</nowiki>}} will produce a test case for upgrading from the previous stable release. | |||
Revision as of 21:15, 5 January 2016
This template is used to produce multiple upgrade test cases for release validation testing, found at Template:Installation_test_matrix#Upgrade.
Various bits of the content are conditionalized, based on template parameters, to let you produce the test cases that cover upgrading from different configurations.
If the first parameter is set, you'll get a test case for that flavor - e.g. {{Testcase upgrade|server}} to get a test case for upgrading the Server flavor.
If the second parameter is set, you'll get a test case for that package set - e.g. {{Testcase upgrade||minimal}} to get a test case for upgrading the minimal package set.
You should only ever set either the first or the second parameter, don't set both together.
If the third parameter is set to live, the test case will mention a live image; it's only intended to be used with the second parameter set (i.e. a package set - not flavor - test case). e.g. {{Testcase upgrade||KDE|live}} to get a test case which covers upgrading a KDE install either via network install or live image.
If the fourth parameter is set to encrypt, the test case will be for upgrading an encrypted system; e.g. {{Testcase upgrade|workstation|||encrypt}} to get a test case which covers upgrading an encrypted Workstation install.
The fifth parameter can be used to specify the release the test case tests upgrading from. Its value is passed to Template:FedoraVersion as its second parameter, for the two places where that template is used to specify the source release. If not set, the source release will be the current stable release. For e.g. {{Testcase upgrade|||||previous}} will produce a test case for upgrading from the previous stable release.