Reduce Windows confusion in renamed 'Install medium prep' section #1174

dksmiffs · 2021-07-08T03:25:57Z

As discussed w/ adw and deeplow here from 2021-06-27 through 06-30, and an attempted improvement to prior (now closed) PR #1168. Again, I welcome suggestions for improvement to this edit.

… section

dksmiffs · 2021-07-08T04:08:42Z

It's unclear to me why the htmlproofer check failed in the pipeline. I'm happy to fix if someone would kindly suggest how.

user/downloading-installing-upgrading/installation-guide.md

andrewdavidwong · 2021-07-08T12:12:34Z

It's unclear to me why the htmlproofer check failed in the pipeline. I'm happy to fix if someone would kindly suggest how.

/home/gitlab-runner/qubesos.github.io/_utils/gitlabci.sh: line 102: 26766 Killed                  htmlproofer ./_site --disable-external --checks-to-ignore ImageCheck --file-ignore ./_site/video-tours/index.html --only_4xx --url-ignore "/qubes-issues/"

@marmarek, @fepitre: Did htmlproofer run out of memory again?

fepitre · 2021-07-08T13:04:53Z

PipelineRetry

andrewdavidwong · 2021-07-08T15:35:51Z

Thanks, @fepitre!

Ok, it looks like all of the failures in the CI log are accurate and specific to this PR now, @dksmiffs:

+ htmlproofer ./_site --disable-external --checks-to-ignore ImageCheck --file-ignore ./_site/video-tours/index.html --only_4xx --url-ignore /qubes-issues/
Running ["ScriptCheck", "LinkCheck"] on ["./_site"] on *.html... 
Ran on 1149 files!
- ./_site/doc/installation-troubleshooting/index.html
  *  linking to internal hash #copying-the-iso-onto-the-installation-medium that does not exist (line 380)
     <a href="/doc/installation-guide/#copying-the-iso-onto-the-installation-medium">write your ISO to a USB key</a>
  *  linking to internal hash #copying-the-iso-onto-the-installation-medium that does not exist (line 389)
     <a href="/doc/installation-guide/#copying-the-iso-onto-the-installation-medium">how to write your ISO to a USB key</a>
- ./_site/news/2019/11/03/qubes-4-0-2-rc2/index.html
  *  linking to internal hash #copying-the-iso-onto-the-installation-medium that does not exist (line 327)
     <a href="/doc/installation-guide/#copying-the-iso-onto-the-installation-medium">copying the ISO onto a sufficiently large USB drive</a>
- ./_site/news/2019/12/13/qubes-4-0-2-rc3/index.html
  *  linking to internal hash #copying-the-iso-onto-the-installation-medium that does not exist (line 328)
     <a href="/doc/installation-guide/#copying-the-iso-onto-the-installation-medium">copying the ISO onto a
sufficiently large USB drive</a>
- ./_site/news/2020/01/02/qubes-4-0-2/index.html
  *  linking to internal hash #copying-the-iso-onto-the-installation-medium that does not exist (line 347)
     <a href="/doc/installation-guide/#copying-the-iso-onto-the-installation-medium">copying the ISO onto a
sufficiently large USB drive</a>
- ./_site/news/2020/01/15/qubes-4-0-3-rc1/index.html
  *  linking to internal hash #copying-the-iso-onto-the-installation-medium that does not exist (line 344)
     <a href="/doc/installation-guide/#copying-the-iso-onto-the-installation-medium">copying the ISO onto a sufficiently large USB
drive</a>
- ./_site/news/2020/01/23/qubes-4-0-3/index.html
  *  linking to internal hash #copying-the-iso-onto-the-installation-medium that does not exist (line 330)
     <a href="/doc/installation-guide/#copying-the-iso-onto-the-installation-medium">copying the ISO onto a sufficiently large USB
drive</a>
htmlproofer 3.16.0 | Error:  HTML-Proofer found 7 failures!

Tag for commit 6eea2bf # -----BEGIN PGP SIGNATURE----- # # iQIzBAABCgAdFiEE4R0VxtIENXaf+qRWjOE3NSoBmhcFAmDqGVAACgkQjOE3NSoB # mhcsdg/6A2zT+GvdR0XtnGxyJoI1WDTHrTSt9e0BiVOWorCs1OoL85leR0jvzWgO # hcXeIxiQK7EnG/QKQC1UMY3gSfL+t8bkaGlXVqcNPFdbVIiHqg/w0KuMaA1pq4mQ # slGtcZyQjjWLLm8RiL4KxshnqVZWqokQwOg3GwL72bNvVxOGb5nJAI9VIyq9+C6N # rqE3qUg3CkzVUxjEFh8kNjGGc/SrpWRlXDHr/6+L5BgGKGcXjhy3S480yRNHU5LI # V/xqkFa+QJaA5F0E+2CIX+fuHSQGl8HrupdXltBRT4VYTibLICGAPsiibpETSrNX # f0lPXUfJAQINw9MAWEvypuFhCHc21xwV/KHVymGuUsbLVFsSUDFrAimb9zBxvqRC # MNAnIBcwrvgxBBg2P4XVTLaV6fKe8vGf3fuiV0Rlxpjk/5oq8KKwCc9LeSd1Q+Sq # hHV72j/yOpXe/FJ10eWMJQLoOGUk/aMu8gAhpjSMBzuDV9kmwp3H2eNNrTrU3hxW # UAvSaNTCK+klmNTWfiPKDaQCtJFhrBqglzo/yNo0JUBhpP6azZ41ISU9pd9lamc5 # kbBWioRjeb6hQ+aBgU6W2UY+q9S6gyvITpfB+PmjU+HzCUqoxpKKe2epQnnm63Tn # 46eceH/DdlFWZcRP0Zi2aMsdyylwRaGVoRASwb90JKRtfVSEd58= # =gYJ6 # -----END PGP SIGNATURE----- # gpg: Signature made 7/10/2021 5:04:00 PM Central Daylight Time # gpg: using RSA key E11D15C6D20435769FFAA4568CE137352A019A17 # gpg: Can't check signature: No public key

andrewdavidwong · 2021-07-12T05:32:35Z

user/downloading-installing-upgrading/installation-guide.md

-  <b>Note:</b>  If you do this on Windows 10, you can only install Qubes
-  without MediaTest, which is not recommended.
+  <b>Note:</b> Choosing this Windows+Rufus method means that you
+  [won't be able](https://github.com/QubesOS/qubes-issues/issues/2051) to choose


Markdown syntax won't work here, because you're inside of an alert. Has to be HTML.

andrewdavidwong · 2021-07-12T05:34:30Z

I actually still don't even know what MediaTest is. Should that be explained somewhere? Is it just an odd way of referring to the option in the Qubes installer to test the installation medium? (I say "odd" because I don't recall the term MediaTest being used, but my memory often fails me.)

unman · 2021-07-12T12:38:05Z

On Sun, Jul 11, 2021 at 10:34:41PM -0700, Andrew David Wong wrote: I actually still don't even know what `MediaTest` is. Should that be explained somewhere? Is it just an odd way of referring to the option in the Qubes installer to test the installation medium? (I say "odd" because I don't recall the term `MediaTest` being used, but my memory often fails me.)

Yes, it's just an odd reference to the "Test this media" option at installation. Not used anywhere else, I dont think.

dksmiffs · 2021-07-12T13:03:26Z

@andrewdavidwong yes, made even more confusing by the CamelCase usage, which leads the reader to believe it might be an intentional thing (I agree with @unman, I think it should not be). This one odd reference was the origin of this PR for me.

dksmiffs · 2021-07-12T14:03:45Z

/home/gitlab-runner/qubesos.github.io/_utils/gitlabci.sh: line 102: 26891 Killed                  htmlproofer ./_site --disable-external --checks-to-ignore ImageCheck --file-ignore ./_site/video-tours/index.html --only_4xx --url-ignore "/qubes-issues/"

Appears to be the same failure that @andrewdavidwong commented on above on 7/8.

fepitre · 2021-07-12T16:24:56Z

PipelineRetry

fepitre · 2021-07-12T16:25:57Z

Ok so it looks like we still have an issue with one of the runner. I've retried with the failing runner disabled. Sorry for the problem.

andrewdavidwong · 2021-07-13T22:29:29Z

user/downloading-installing-upgrading/installation-guide.md

+installation medium of your choice, such as a USB drive, dual-layer DVD,
+or Blu-ray disc. The size of each Qubes ISO is available on the


Reordered list to put most common and recommended medium first.

andrewdavidwong · 2021-07-13T22:33:01Z

user/downloading-installing-upgrading/installation-guide.md

+<div class="alert alert-info" role="alert">
+  <i class="fa fa-info-circle"></i>
+  <b>Note:</b> Using Rufus to create the installation medium means that you
  <a href="https://github.com/QubesOS/qubes-issues/issues/2051">won't be able</a>
-  to choose the "Test this media & install Qubes" option recommended in the
-  Installation section below. Instead, you'll only be able to choose the
-  "Install Qubes" option.
+  to choose the "Test this media and install Qubes OS" option mentioned in the
+  example below. Instead, choose the "Install Qubes OS" option.


This doesn't deserve "warning" (as opposed to "info"), because the "test this media" option isn't being "recommended" below. As it states at the beginning of that section, it's simply showing you an example with the most common settings.

The previous wording is likely to get users worried over nothing. This alert still might. Many users still won't understand it at all and become terribly confused. I'm of half a mind to remove it, but it's reasonable to let users know that using Rufus will disallow the test option, since they might care about it.

@andrewdavidwong I like your wording better, and I agree with you about not getting users worried over nothing. I think your wording definitely lessens potential worry.

andrewdavidwong · 2021-07-13T22:35:41Z

@fepitre:

Ok so it looks like we still have an issue with one of the runner. I've retried with the failing runner disabled. Sorry for the problem.

Seems like there's no CI check at all now. Is that expected?

fepitre · 2021-07-14T06:26:06Z

PipelineRetry

fepitre · 2021-07-14T06:28:42Z

@fepitre:

Ok so it looks like we still have an issue with one of the runner. I've retried with the failing runner disabled. Sorry for the problem.

Seems like there's no CI check at all now. Is that expected?

No. Unfortunately, there is some recent random issue with Gitlab/Github CI events that we catch to report status. I still don't find why there is such failure yet.

Reduce Windows confusion in renamed 'Installation medium preparation'…

64b1015

… section

unman requested changes Jul 8, 2021

View reviewed changes

user/downloading-installing-upgrading/installation-guide.md Show resolved Hide resolved

andrewdavidwong assigned dksmiffs Jul 8, 2021

dksmiffs added 3 commits July 11, 2021 13:30

Undo change to 'Copying the ISO' header, not worth the broken links

cc8155f

Add clarification based on PR #1174 feedback

4055787

andrewdavidwong reviewed Jul 12, 2021

View reviewed changes

Fix link to HTML syntax (#1174)

13f7997

Copyedit

4ff7399

andrewdavidwong reviewed Jul 13, 2021

View reviewed changes

andrewdavidwong merged commit 392c994 into QubesOS:master Jul 14, 2021

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Reduce Windows confusion in renamed 'Install medium prep' section #1174

Reduce Windows confusion in renamed 'Install medium prep' section #1174

dksmiffs commented Jul 8, 2021

dksmiffs commented Jul 8, 2021

andrewdavidwong commented Jul 8, 2021

fepitre commented Jul 8, 2021

andrewdavidwong commented Jul 8, 2021

andrewdavidwong Jul 12, 2021

andrewdavidwong commented Jul 12, 2021

unman commented Jul 12, 2021 via email

dksmiffs commented Jul 12, 2021

dksmiffs commented Jul 12, 2021

fepitre commented Jul 12, 2021

fepitre commented Jul 12, 2021 •

edited

Loading

andrewdavidwong Jul 13, 2021

andrewdavidwong Jul 13, 2021 •

edited

Loading

dksmiffs Jul 14, 2021

andrewdavidwong commented Jul 13, 2021

fepitre commented Jul 14, 2021

fepitre commented Jul 14, 2021

		installation medium of your choice, such as a USB drive, dual-layer DVD,
		or Blu-ray disc. The size of each Qubes ISO is available on the

Reduce Windows confusion in renamed 'Install medium prep' section #1174

Reduce Windows confusion in renamed 'Install medium prep' section #1174

Conversation

dksmiffs commented Jul 8, 2021

dksmiffs commented Jul 8, 2021

andrewdavidwong commented Jul 8, 2021

fepitre commented Jul 8, 2021

andrewdavidwong commented Jul 8, 2021

andrewdavidwong Jul 12, 2021

Choose a reason for hiding this comment

andrewdavidwong commented Jul 12, 2021

unman commented Jul 12, 2021 via email

dksmiffs commented Jul 12, 2021

dksmiffs commented Jul 12, 2021

fepitre commented Jul 12, 2021

fepitre commented Jul 12, 2021 • edited Loading

andrewdavidwong Jul 13, 2021

Choose a reason for hiding this comment

andrewdavidwong Jul 13, 2021 • edited Loading

Choose a reason for hiding this comment

dksmiffs Jul 14, 2021

Choose a reason for hiding this comment

andrewdavidwong commented Jul 13, 2021

fepitre commented Jul 14, 2021

fepitre commented Jul 14, 2021

fepitre commented Jul 12, 2021 •

edited

Loading

andrewdavidwong Jul 13, 2021 •

edited

Loading