|
|
[[!meta title="Restructure our support page"]]
|
|
|
---
|
|
|
title: Restructure our support page
|
|
|
---
|
|
|
|
|
|
Parent ticket: [[!tails_ticket 15130]]
|
|
|
|
|
|
Parent ticket: tails/tails#15130
|
|
|
|
|
|
Current problems
|
|
|
================
|
... | ... | @@ -12,7 +15,7 @@ Redmine, feature request) |
|
|
- The difference between our different support content is not clear
|
|
|
enough (known issues, documentation, FAQ).
|
|
|
|
|
|
During the expert review ([[!tails_ticket 14548]]), the person would
|
|
|
During the expert review (tails/tails#14548), the person would
|
|
|
have gone to:
|
|
|
|
|
|
1. FAQ: which wouldn't help
|
... | ... | @@ -43,20 +46,18 @@ Ideas |
|
|
- Restructure the page to help differently people who either cannot
|
|
|
start Tails or are in Tails already.
|
|
|
|
|
|
- Split [[!tails_gitweb wiki/src/support/known_issues.mdwn]] into two:
|
|
|
- Split [wiki/src/support/known issues.mdwn](https://gitlab.tails.boum.org/tails/tails/-/blob/master/wiki/src/support/known_issues.mdwn) into two:
|
|
|
|
|
|
- Issues that prevent Tails from starting: [[!tails_gitweb
|
|
|
wiki/src/support/known_issues/starting.mdwn]] [1]
|
|
|
- Issues that don't: [[!tails_gitweb
|
|
|
wiki/src/support/known_issues.mdwn]] [2]
|
|
|
- Issues that prevent Tails from starting: [wiki/src/support/known issues/starting.mdwn](https://gitlab.tails.boum.org/tails/tails/-/blob/master/wiki/src/support/known_issues/starting.mdwn) [1]
|
|
|
- Issues that don't: [wiki/src/support/known issues.mdwn](https://gitlab.tails.boum.org/tails/tails/-/blob/master/wiki/src/support/known_issues.mdwn) [2]
|
|
|
- Cross-reference these two pages
|
|
|
|
|
|
Troubles starting Tails
|
|
|
-----------------------
|
|
|
|
|
|
- Create a page dedicated to issues starting Tails and link it from
|
|
|
[[!tails_gitweb wiki/src/support.mdwn]] and
|
|
|
[[!tails_gitweb wiki/doc/first_steps/bug_reporting.mdwn]]:
|
|
|
[wiki/src/support.mdwn](https://gitlab.tails.boum.org/tails/tails/-/blob/master/wiki/src/support.mdwn) and
|
|
|
[wiki/doc/first steps/bug reporting.mdwn](https://gitlab.tails.boum.org/tails/tails/-/blob/master/wiki/doc/first_steps/bug_reporting.mdwn):
|
|
|
|
|
|
- Inline troubleshooting sections from the installation instructions
|
|
|
- List or inline known issues that prevent Tails from starting [1]
|
... | ... | @@ -67,8 +68,7 @@ Troubles inside Tails |
|
|
- Improve a bit the upgrade instructions "*Make sure you are using the
|
|
|
latest version*".
|
|
|
|
|
|
Like we're doing on [[!tails_gitweb
|
|
|
wiki/src/install/inc/steps/verify_up-to-date.inline.mdwn]]
|
|
|
Like we're doing on [wiki/src/install/inc/steps/verify up-to-date.inline.mdwn](https://gitlab.tails.boum.org/tails/tails/-/blob/master/wiki/src/install/inc/steps/verify_up-to-date.inline.mdwn)
|
|
|
|
|
|
- List hot topics on help desk
|
|
|
|
... | ... | @@ -84,8 +84,7 @@ Troubles inside Tails |
|
|
|
|
|
We could have inline files listing issues for each release.
|
|
|
|
|
|
For example: [[!tails_gitweb
|
|
|
wiki/src/news/version_3.3/issues.inline.mdwn]]
|
|
|
For example: [wiki/src/news/version 3.3/issues.inline.mdwn](https://gitlab.tails.boum.org/tails/tails/-/blob/master/wiki/src/news/version_3.3/issues.inline.mdwn)
|
|
|
|
|
|
This file would be inlined from both:
|
|
|
- The support page
|
... | ... | @@ -104,8 +103,7 @@ Troubles inside Tails |
|
|
- Embed more information about the documentation in the support page
|
|
|
|
|
|
We could reuse the index pages that we already have for the different
|
|
|
documentation sections ([[!tails_gitweb
|
|
|
wiki/src/doc/first_steps.index.mdwn]]) and display them in accordions
|
|
|
documentation sections ([wiki/src/doc/first steps.index.mdwn](https://gitlab.tails.boum.org/tails/tails/-/blob/master/wiki/src/doc/first_steps.index.mdwn)) and display them in accordions
|
|
|
(toggles).
|
|
|
|
|
|
See how Chrome does that:
|
... | ... | @@ -159,3 +157,4 @@ Next steps |
|
|
- Release managers
|
|
|
* Create wireframes of the final page
|
|
|
* Organize incremental work to implement all this
|
|
|
|