Feedback- "Upgrading the Fedora 23 Template"

[Patrick Bouldin]

Hi, re: https://www.qubes-os.org/doc/template/fedora/upgrade-23-to-24/

Really nice job on the instructions, wow! Very detailed and precise. I could maybe add a few tidbits to consider adding on the documentation. Probably not needed if I could do it but anyway...

I would suggest indenting steps 5 through 6 to really drive home it's a path taken only if needed - maybe even make step 4 a decision tree at the end.

Step 7 - To help newer folks, just like you did in step 9-3, consider adding (from dom0). I realize it's obvious, but I missed it.

Step 9 - I would consider not saying this is optional... You might say "Strongly Suggested!"

Step 9-2 - consider adding "Look at the Qubes VM manager, highlight and right-click any and all VMs that show Fedora 23, and then change the template to Fedora 24.

Step 10 - Might add a note: Be careful not to remove fedora-24 !!!  I almost did it, no idea how, temporary dyslexia maybe!

Well, I'm "in the masses" of folks, some of these things may seem too elementary but perhaps it would help some.

Again, great job!

Patrick

Dallas

[Andrew David Wong]

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

On 2016-12-21 19:06, Patrick Bouldin wrote:
> Hi, re:
> https://www.qubes-os.org/doc/template/fedora/upgrade-23-to-24/
>
> Really nice job on the instructions, wow! Very detailed and
> precise. I could maybe add a few tidbits to consider adding on the
> documentation. Probably not needed if I could do it but anyway...
>
> I would suggest indenting steps 5 through 6 to really drive home
> it's a path taken only if needed

Updated.

> maybe even make step 4 a decision tree at the end.
>

Not sure what you have in mind. (It's just a single conditional.)

> Step 7 - To help newer folks, just like you did in step 9-3,
> consider adding (from dom0). I realize it's obvious, but I missed
> it.
>

The prompt portion contains "dom0" or "fedora-24" as appropriate. I've
added notes about this at the beginning of each set of instructions.

With regard to this specific step, it wouldn't make sense to remove
the cache file from fedora-24, as it doesn't exist there (and trying
to do so wouldn't be harmful).

> Step 9 - I would consider not saying this is optional... You might
> say "Strongly Suggested!"
>

Changed to "recommended." Some of the substeps truly are optional. For
example, many users won't want to set the new template as their
default TemplateVM or DVM template.

> Step 9-2 - consider adding "Look at the Qubes VM manager, highlight
> and right-click any and all VMs that show Fedora 23, and then
> change the template to Fedora 24.
>

Updated. Note that right-clicking is not the only way. You can also
click the "VM Settings" button at the top of QM.

> Step 10 - Might add a note: Be careful not to remove fedora-24 !!!
> I almost did it, no idea how, temporary dyslexia maybe!
>

Added a warning.

> Well, I'm "in the masses" of folks, some of these things may seem
> too elementary but perhaps it would help some.
>
> Again, great job! Patrick Dallas
>

Thanks for the feedback!

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

iQIcBAEBCgAGBQJYW2y6AAoJENtN07w5UDAwLCsP/3nqDgHWuS5Txt7HCYgrbhEn
CxN0m7Pu+lOKT9Nhq1pNgKZiWxCaNqIXAeF2nvIdlkJgj0T7JuYci3g3a8KUvUC2
E8II5tpeurE3Fd7QTDfl843mEw/tEjUjBxSZryJaW/PgfGU7WWRRKtlzbCZtjlz0
XIG8YHkD+ea0k5bGtDr4669IsmYamXZsRjgEO7N6f2TNM1rZf4jTQ+7WYShspRfM
XWQfU4f1RtkmjUBeCrIK9Im2rfgqj9vFrTbcFRSEkrXBbUpE4qgDscN6PdxUjxIe
6AgtPqF3TAcP8kPe5HumERhTUFKjYKMYlwT7h+LnSxebJBDHnn2TwYJVUYSgrjZG
2kvQekKpl/+o+RRPk9gKlZMJpuRb9siLAdIAyaZF3urhiOl7C9Gx2iUM91MU8wLB
I7Eq8B75p2aX79MlSm8v6IKIq3CRSdbX208czm7pW3By4Kz/cdrt5YsNjtG4qSwL
YHGOACB9QFu3sjr1MH5D6wiqbzycaKMX0S9rFq7uGlbXMw7/NFBO0y35fwy5EgdZ
IkD7hjQX2j/eH7Cq/niBrRGsCl9s7uwiWV4MvrPE8xFmOn+oLykj+VUGU1fWew+j
HJcltdSTDFGU+GSb33uhhhoLfS5S1jY1OjA32by8OECemFGFE7h4nd+MfzFiNWGM
CqY74Vujdxgg9cBrOqdc
=iTCm
-----END PGP SIGNATURE-----