Restructure the installation pages
Terminology
-
The router is the set of pages that help the user choose their installation scenario, for example:
-
The overview appears after the router to summarize the process, for example:
-
The download page appears after the overview, for example:
-
The steps are the installation steps themselves, for example:
Current problems
-
In #18074 (closed), several participants had a hard time finding the link to the steps from the download page, not verifying their download didn't help. After that, they went free style without installing and run into big troubles.
These people went frequently back-and-forth between router, overview, download, and steps.
For example, they went back to the overview when they were lost without knowing what to do with the USB image because they missed the link to the steps from the download page.
The fact that the download page is not linear didn't help: the warnings are at the bottom of the page and the link to the steps is before the warnings.
Should we merge the overview, download, and steps to have all the process on a single page?
Would merging overview and download make more people skip the overview and still get lost in the process?
-
In #18074 (closed), only 1 person verified their download.
On top of improving the verification instructions (#18776 (closed)) and mentioning the verification in the overview (#18774 (closed)), should we make it more visible or get people to pause more at this step?
How might the structure of the page make it so that more people verify their download?
-
In #18074 (closed), nobody commented on the warnings.
Maybe it's not a big deal given the test participants didn't feel personally at risk.
How might we get more at-risk users pay attention to the warnings?
-
Hardware warnings are not consistently integrated (#17441 (closed))
- https://tails.boum.org/doc/about/requirements/
- https://tails.boum.org/support/known_issues/
- https://tails.boum.org/install/mac/
- https://tails.boum.org/install/mac/usb/#back (right before the anchor)
How much should we bother people about hardware requirements and when is the best time to do so?
-
The installation pages are not very exciting visually.
In #18074 (closed), nobody commented on the intro of the router.
Now that we have @anhdres, we could add visual to support better this long process emotionally.
Since the process became simpler, how do we want the beginning of the process to feel to users?
What are the best opportunities to support the process with visuals? How should they feel?
-
SEO is tricky with the current multiple pages
Currently we index the overview and have
noindex
in the download page and the steps to prevent people from ending on the steps without downloading. This means that the content of the steps is not searchable. For example, searching for "install etcher" leads to pretty poor results on DuckDuckGo. -
The router is more complicated than it should.
We created the router in 2015 because Mac users had complicated options to choose from and because we wanted to put forward that installing from another Tails was always much easier. It's not the case anymore since we distribute USB images.
How might we improve the structure of the router?
Open questions and ideas
- Move "Download" after "Install Etcher"?
- Makes it clear that people can't free style after the download
- Makes it clear that it can't be done from a phone
- Move "Warnings"
- Before "Verification" to encourage people to read them while download?
- Just before running Tails to remove clutter from the download and verification steps?
- How many stops do we want for users as they move forward in the process?
- 1 stop for each step
- Only strategic stops, even if they don't match the big steps
- No strong stop but scroll snapping
- How many steps?
- Are all the steps on the page are mapped to a step in the overview or in-page navigation?
TODO
-
Prepare design workshop with boyska -
Group inlines on all affected pages -
/install/windows -
/install/mac -
/install/linux -
/install/expert -
/install/dvd -
/install/vm -
/install/clone/pc -
/install/clone/mac -
/upgrade/windows -
/upgrade/clone -
/upgrade/tails -
/upgrade/linux -
/upgrade/mac -
Rename PO files of moved pages
-
-
Router -
Integrate cloning in router -
Split /install/clone/mac and /install/clone/pc -
Create placeholder for /install/clone -
Clean assistant.css -
Review RWD
-
-
Overview -
Add links from overview to content -
Rewrite overview without Bootstrap -
Add back overview to cloning scenarios
-
-
Download -
Remove "Continue installing or upgrading" -
Remove "openpgp" in download.css -
Split download, verify, and warnings -
Adapt download only page -
Add big steps for verify -
Remove warnings from upgrade pages -
Rewrite download and verify as h1 steps -
Improve style of download and verify sections -
Check no-JS versions -
Review download.css -
Review download.js -
Test verification
-
-
Steps -
/install/windows -
/install/mac -
/install/linux -
/install/expert -
/install/dvd -
/install/vm -
/install/clone/pc -
/install/clone/mac -
/upgrade/windows -
/upgrade/clone -
/upgrade/tails -
/upgrade/linux -
/upgrade/mac -
Remove hidden steps -
Adapt flow of /dvd -
Add step numbers on /install/dvd and /install/vm -
Improve link from from /vm to /doc -
Clean steps.css -
Add big steps for Etcher -
Add image on "Welcome to Tails" and "Welcome to your new Tails!"? -
Fix step images -
Fix display of toggle (eg. "Why") -
Adapt download and verify of /install/expert -
Check step numbers
-
-
Move OS requirements earlier (and clarify context? #18764 (closed)) -
Fix back links and QR codes -
/install/windows -
/install/clone/pc -
/install/clone/mac
-
-
Test RWD -
Style better the back link -
Test print -
Fix style of button to download Etcher -
Review expert.css -
Get rid of '#greeter'
-
-
Wrap up -
Check where I need to wrap meta title in div -
Delete install/inc/overview/vm (a89b65e7) -
Remove *-overview -
Remove *-download -
Remove $os/usb -
Improve page titles -
Rewrite outro without Bootstrap -
Rename /install/win to /install/windows -
Remove noindex on main pages -
Search for col-
-
Update Get rid of Bootstrap everywhere on our website (#18142 - closed) -
Integrate hardware requirements in overview (#17441 (closed)) -
Apple M1 -
Mac keyboard and mouse
-
-
Remove DocBook classes on any string that was changed -
Review alt tags -
Check broken links -
Check pages linking to /install/clone -
Review a few key scenarios entirely -
Review RWD on key pages -
Update list of core pages -
Update PO files -
Update design doc -
Compare language stats: 17% less strings on core pages :)
-
-
Redirect /install/ os/usb to /install/
os (sysadmin#17892 (closed))