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