Adjust for ikiwiki → GitLab wiki authored by intrigeri's avatar intrigeri
[[!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