Fedora upgrade doc naming

[Marek Marczykowski-Górecki]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Hi,

Currently documentation about upgrading Fedora templates is named
"Upgrading the Fedora 23 Template", "Upgrading the Fedora 21 Template"
etc. IMO this suggest installing ordinary updates within Fedora release,
not upgrading between Fedora releases. What about renaming it to
"Upgrading the Fedora 23 Template to Fedora 24"? Or maybe just
"Upgrading to the Fedora 23 Template"?

- --
Best Regards,
Marek Marczykowski-Górecki
Invisible Things Lab
A: Because it messes up the order in which people normally read text.
Q: Why is top-posting such a bad thing?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQEcBAEBCAAGBQJYOw5BAAoJENuP0xzK19csFlgH/1nlUo2L3IPgfdRjk6B8B6xV
lKJs0qHECgu9VCsbp2I3m/VQFbJsxcg21bOfkMuVOjDSgCXqwgeQnhIpaxTWff8k
hHTCAL748NefHvHa6upbfiMVUeQEcjVXY7cjx4o8hK2+2++q8j8smycHBHE5mgAh
F3ZHyV8rxxs68hWJv/PYdfcigO//thRUrNtyGK4j1kfSYAz1UAUXnZNaxGrmz7Vp
QWk3qQ8BQMaXcpyCphGLQ3Dn5mrF7QRiBeFWByDS9OQUOaMOEoMkdQRj1uhHc9JB
nfDWgGyNXn7xgTTxl2QEv7NWTjDM6C7NMCT2WlI2TjRmW6X+A8C08cpCYrsXPjQ=
=eZ+5
-----END PGP SIGNATURE-----

[Jean-Philippe Ouellet]

On Sun, Nov 27, 2016 at 11:48 AM, Marek Marczykowski-Górecki
<marm...@invisiblethingslab.com> wrote:
> "Upgrading the Fedora 23 Template to Fedora 24"?

Sounds fine to me.

> "Upgrading to the Fedora 23 Template"?

Implies you are on <23 and does not not suggest it provides
instructions for 23->24, etc.

How about combining them & using "Upgrading Fedora templates to new
major releases"?

[Marek Marczykowski-Górecki]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

On Sun, Nov 27, 2016 at 02:56:02PM -0500, Jean-Philippe Ouellet wrote:
> On Sun, Nov 27, 2016 at 11:48 AM, Marek Marczykowski-Górecki
> <marm...@invisiblethingslab.com> wrote:
> > "Upgrading the Fedora 23 Template to Fedora 24"?
> Sounds fine to me.
>
> > "Upgrading to the Fedora 23 Template"?
> Implies you are on <23 and does not not suggest it provides
> instructions for 23->24, etc.

I meant 24 there...

> How about combining them & using "Upgrading Fedora templates to new
> major releases"?

There are not exactly the same, for example 20->21 instruction have
additional step of removing conflicting packages. Also older releases
use yum, newer - dnf.
But indeed, it may still be a good idea to combine the pages, and have
release-specific sections below, like here:
https://fedoraproject.org/wiki/Upgrading_Fedora_using_package_manager

- --
Best Regards,
Marek Marczykowski-Górecki
Invisible Things Lab
A: Because it messes up the order in which people normally read text.
Q: Why is top-posting such a bad thing?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQEcBAEBCAAGBQJYO0z1AAoJENuP0xzK19cskIoH/1XT2M5Yw/lWQ02PKhmEFvlX
S3gtEXF79FXgB9f0e4GD54SP+i/P7yYx7k82KKgsZbHhFboiyYuKUUl3DVCf5E9P
jXGM+M4I5wxF8arVKnno/3ytO0YPeJLjvsQgASXKeauH+33hZvfn4EkfDjAy/lty
h8gILoOabyg306/b3hSPEwH8sm9htOV6y1TmWaM3v7WhPaF5c7n9110ZQM24+KB6
hoZqjrtXKRVXOMLeX+u9M6EEhlhNLCz+eRRtJGU30K6j5AeCc50RtHvtK3R0XsdE
SsDywEJj/r8Ercom/iy7id4pYURkTy3Sw8MkakEZ2kisKAE0QjZxEgnERdsunIs=
=6BL0
-----END PGP SIGNATURE-----

[Unman]

On Sun, Nov 27, 2016 at 02:56:02PM -0500, Jean-Philippe Ouellet wrote:

That would result in overly long instructions.

One advantage of keeping the page per upgrade model is that it makes it
easier to drop old instruction sets.
For what it's worth, I don't see a problem with the existing heading - it
does not carry the implication that Marek sees. In any case the proposed
text is already there on each page in the Summary heading.

unman

[Chris Laprise]

On 11/27/2016 04:15 PM, Marek Marczykowski-Górecki wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA256
>
> On Sun, Nov 27, 2016 at 02:56:02PM -0500, Jean-Philippe Ouellet wrote:
>> On Sun, Nov 27, 2016 at 11:48 AM, Marek Marczykowski-Górecki
>> <marm...@invisiblethingslab.com> wrote:
>>> "Upgrading the Fedora 23 Template to Fedora 24"?
>> Sounds fine to me.
>>
>>> "Upgrading to the Fedora 23 Template"?
>> Implies you are on <23 and does not not suggest it provides
>> instructions for 23->24, etc.
> I meant 24 there...
>
>> How about combining them & using "Upgrading Fedora templates to new
>> major releases"?
> There are not exactly the same, for example 20->21 instruction have
> additional step of removing conflicting packages. Also older releases
> use yum, newer - dnf.
> But indeed, it may still be a good idea to combine the pages, and have
> release-specific sections below, like here:
> https://fedoraproject.org/wiki/Upgrading_Fedora_using_package_manager
>
> - --

Does it make sense to keep instructions for "upgrading" a template to an
OS version that's past end-of-life?

Chris

[Unman]

As an intermediate step toward one that is supported, it may be
necessary.

[Andrew David Wong]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

On 2016-11-27 08:48, Marek Marczykowski-Górecki wrote:
> Hi,
>
> Currently documentation about upgrading Fedora templates is named
> "Upgrading the Fedora 23 Template", "Upgrading the Fedora 21 Template"
> etc. IMO this suggest installing ordinary updates within Fedora release,
> not upgrading between Fedora releases. What about renaming it to
> "Upgrading the Fedora 23 Template to Fedora 24"? Or maybe just
> "Upgrading to the Fedora 23 Template"?
>

I've reorganized all the TemplateVM pages:

https://github.com/QubesOS/qubes-doc/commit/7aaf15b103b532f8c850344df8f97170f879c75d

- --
Andrew David Wong (Axon)
Community Manager, Qubes OS
https://www.qubes-os.org
-----BEGIN PGP SIGNATURE-----

iQIcBAEBCgAGBQJYO387AAoJENtN07w5UDAwZG8QAMZZFRLiQ1eOWd9UUa5nOOep
i8QrvIFhX+lyNa00iyRpvMQbB3RzCvwC5B1O0PuGNFgb0RFkFVjAGihrAD/VF9RV
3ZU6VaK8ALYYKZYr2xpm6bdudcCGEdjf5OHL4C0XAL52g9h7BNxmgdpPDOIlJcVV
TtLvI+JzdQaZ+ogw4cqmIBY1u5doVCDOPpae5IsQbX79CH2rkAxeqKZiam0TK7Di
o5S7vZi6yq6EAp2cB0TuYvL8mWE6k2NaahAqoFkrxWTcsBdq+YI/2gnV/43VRAhv
07waafBCUToWL9XuQMKEO6fYhr65M2yTHcaN5M7KIGm1tezTXGRsdOLlwXlH6dEi
rLedysEN1ZaxFAV+By7IBXlQqe7HxIo+IAV8rOZIBhB/paBk45zGLU8E/iln4FpT
kdIfnb6VRmgNqT037qDDv7djj3LXdE21YBZeQfbUDZ+fxOVYpg1Pw5CY511COWrD
2BLpf2L5lLLpu1GzuPLOBcncixBoGeY1b8U8VtJklsz+EU3MIuuTLv/RuHdZEsOw
nYNB3Raj9Cfd89Ayi14iq27K3uom01Ef67Bfz3RjpZLHHT7qedVk9wCXrVdYU0PR
fbrgr8TyO+1CFKDID7gWjzZObUp/HbXQKTQIznxTXkZ17otmFVFpCLg38NHnFx8A
YB/KoSFsrp7p5NB6bB7A
=JpNL
-----END PGP SIGNATURE-----

[Marek Marczykowski-Górecki]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

On Sun, Nov 27, 2016 at 04:50:05PM -0800, Andrew David Wong wrote:
> On 2016-11-27 08:48, Marek Marczykowski-Górecki wrote:
> > Hi,
> >
> > Currently documentation about upgrading Fedora templates is named
> > "Upgrading the Fedora 23 Template", "Upgrading the Fedora 21 Template"
> > etc. IMO this suggest installing ordinary updates within Fedora release,
> > not upgrading between Fedora releases. What about renaming it to
> > "Upgrading the Fedora 23 Template to Fedora 24"? Or maybe just
> > "Upgrading to the Fedora 23 Template"?
> >
>
> I've reorganized all the TemplateVM pages:
>
> https://github.com/QubesOS/qubes-doc/commit/7aaf15b103b532f8c850344df8f97170f879c75d

Thanks!

- --
Best Regards,
Marek Marczykowski-Górecki
Invisible Things Lab
A: Because it messes up the order in which people normally read text.
Q: Why is top-posting such a bad thing?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iQEcBAEBCAAGBQJYPNPwAAoJENuP0xzK19cs2AEH/1zKfFqE1WAFsN66gOae2Swo
lDeGMj/jF/hBChKxQZVYLnaIJhRrIUejpMZFDPGmtMoJ1ClNMbbW7b4pvSXlWKvO
+eo6pL/2Bb2dqmpTKs7xKk+6kCDxPRaekm9x/MIVY/ob3gjjDx4qHYA7iZPhq7MY
5ACI2ky7EJGEvgPKBMzgxk2Zl2G8V/3RodDT0+FYha+IlWlcR9itqxOjW3QMTuBC
R4qbOGueyDldfrbkSsNRF77EsksuFfjiaEPLAk/cZIY8yz6F7cYrz5Iyq1JgBcP/
opkkI3q1rDZeBxG+itA8CscgvrCvrUWe5NAByZzieSbirXPmKYwAq2NPi4LRfNQ=
=YAup
-----END PGP SIGNATURE-----