From a76235b57d6c6be6987556e63e6fa8593e704ca0 Mon Sep 17 00:00:00 2001 From: Alexandre Aubin Date: Thu, 11 Feb 2021 00:42:09 +0100 Subject: [PATCH] Add troubleshooting general advice page, tweaks in /help --- .../08.troubleshooting/troubleshooting.fr.md | 26 +++++++ .../08.troubleshooting/troubleshooting.md | 26 +++++++ pages/01.administrate/admindoc.fr.md | 2 +- pages/01.administrate/admindoc.md | 2 +- pages/03.community/03.help/help.fr.md | 67 ++++++------------- pages/03.community/03.help/help.md | 9 ++- 6 files changed, 79 insertions(+), 53 deletions(-) create mode 100644 pages/01.administrate/08.troubleshooting/troubleshooting.fr.md create mode 100644 pages/01.administrate/08.troubleshooting/troubleshooting.md diff --git a/pages/01.administrate/08.troubleshooting/troubleshooting.fr.md b/pages/01.administrate/08.troubleshooting/troubleshooting.fr.md new file mode 100644 index 00000000..a6f1e415 --- /dev/null +++ b/pages/01.administrate/08.troubleshooting/troubleshooting.fr.md @@ -0,0 +1,26 @@ +--- +title: Dépannage +template: docs +taxonomy: + category: docs +routes: + default: '/troubleshooting' +--- + +Voici quelques conseils généraux à suivre lorsque vous rencontrez des problèmes avec votre serveur. + +## 0. Ne paniquez pas. + +Restez calme. La plupart des problèmes sont moins grave que ce que les débutants pensent. Pour l'amour de Dieu (ou de votre déité, animal, nourriture préférée), ne sautez pas à pieds joint dans la "spirate de réinstallation" en pensant que réinstaller à partir de zéro va magiquement résoudre vos problèmes. Réinstaller est une opération lourde et n'est pas une bonne stratégie sur le long-terme pour résoudre les problèmes. Vous finirez par vous lasser et n'apprendrez rien. + +## 1. Regardez sur le forum ou bugtrackers si quelqu'un a eu un problème similaire. + +Cherchez dans [le forum](https://forum.yunohost.org) des fils de discussions qui discutent de choses similaire aux problème que vous rencontrez. Si vous avez un soucis lié à une application en particulier, vous pouvez également tenter de chercher un ticket similaire sur le bugtracker de l'application, par exemple [ici se trouve le bugtracker de l'app wordpress](https://github.com/YunoHost-Apps/wordpress_ynh/issues). + +## 2. Demandez de l'aide + +Soit sur [le forum](https://forum.yunohost.org) ou bien le chat : c.f. [cette page](/help) + +!!! POUR L'AMOUR DE DIEU, PRIÈRE DE fournir du contexte ! Les bénévoles ne peuvent PAS vous aider si vous ne prenez pas *cinq* petites minutes pour décrire votre contexte : quel type de hardware, quelle version de Yunohost, qu'est-ce que vous essayez de faire, ce qui s'est passé, et **les journaux (logs) correspondants**. + + diff --git a/pages/01.administrate/08.troubleshooting/troubleshooting.md b/pages/01.administrate/08.troubleshooting/troubleshooting.md new file mode 100644 index 00000000..8cf90dbc --- /dev/null +++ b/pages/01.administrate/08.troubleshooting/troubleshooting.md @@ -0,0 +1,26 @@ +--- +title: Troubleshooting +template: docs +taxonomy: + category: docs +routes: + default: '/troubleshooting' +--- + +Here are some general advices when encountering issues with your server. + +## 0. Don't panic. + +Stay calm. Most issues are less worse than newcomers usually think. For the love of God (or your favourite deity / animal / food), please don't jump into the "reinstallation spiral" thinking reinstalling your serve from scratch will magically fix stuff. Reinstalling is a heavy operation and is not a good long-term strategy for fixing problems. You will get tired and won't learn anything. + +## 1. Look for similar issues on the forum or bugtrackers. + +Search [the forum](https://forum.yunohost.org) for topics similar to the issue you're encountering. If you have issues with a specific app, you may also want to check the corresponding bugtracker of the app, for example [here is the bugtracker for the Wordpress app](https://github.com/YunoHost-Apps/wordpress_ynh/issues). + +## 2. Ask for help + +Either on [the forum](https://forum.yunohost.org) or the chat : c.f. [this page](/help) + +!!! FOR THE LOVE OF GOD, PLEASE provide basic context ! Volunteers can NOT help you if you do not take *five* minutes to describe your context : which kind of hardware, which Yunohost version, what you are trying to do, what you tried, what happened and **the corresponding logs**. + + diff --git a/pages/01.administrate/admindoc.fr.md b/pages/01.administrate/admindoc.fr.md index c98b8a06..bedfb7c6 100644 --- a/pages/01.administrate/admindoc.fr.md +++ b/pages/01.administrate/admindoc.fr.md @@ -1,5 +1,5 @@ --- -title: Administrer +title: Guide d'administration template: chapter taxonomy: category: docs diff --git a/pages/01.administrate/admindoc.md b/pages/01.administrate/admindoc.md index 17ed33de..244b461a 100644 --- a/pages/01.administrate/admindoc.md +++ b/pages/01.administrate/admindoc.md @@ -1,5 +1,5 @@ --- -title: Administrate +title: Admin guide template: chapter taxonomy: category: docs diff --git a/pages/03.community/03.help/help.fr.md b/pages/03.community/03.help/help.fr.md index 545b3ff6..44b1740d 100644 --- a/pages/03.community/03.help/help.fr.md +++ b/pages/03.community/03.help/help.fr.md @@ -7,60 +7,35 @@ routes: default: '/help' --- -

Connectez-vous au salon de support

+## Connectez-vous au salon de support !!! **ProTips™** -!!! - Pas besoin de demander si vous pouvez poser une question - posez-la directement ! -!!! - *Soyez patient*, cela peut prendre plusieurs minutes avant que quelqu'un remarque vos messages. +!!! - Don't ask to ask, just ask ! +!!! - *Be patient*, it can take a few minutes before someone sees your messages. -
+[center] + +[/center] - +!!! **Note:** ce salon est accessible via +!!! - Matrix (`#freenode_#yunohost:matrix.org` [en utilisant Element](https://app.element.io/#/room/#freenode_yunohost:matrix.org)) +!!! - IRC (`#yunohost` on freenode, [en utilisant Kiwiirc](https://kiwiirc.com/nextclient/?settings=7b72a0a81838360686798199ed53624f&target=blank)) +!!! - XMPP (`support@conference.yunohost.org`) -
-
-Note : ce salon est accessible via IRC (#yunohost sur freenode en utilisant Kiwiirc), via XMPP (support@conference.yunohost.org), ou Matrix (#freenode_#yunohost:matrix.org - en utilisant Element). -
+## ... or ask on the forum ! -

... ou demandez sur le forum !

+[center] +[[fa=comment /] Aller sur le forum](https://forum.yunohost.org/?target=_blank&classes=btn,btn-lg,btn-success) +[/center] -
- -
+## You've found a bug ? -

Vous avez trouvé un bug ?

+!!!! Please report bugs on our bugtracker or contact the developers -
-
-Vous pouvez rapporter le bug sur le bugtracker ou contacter les développeurs

- - -
-
-Note : vous pouvez aussi vous connecter aux salons de dev, via votre client XMPP favori, à
-dev@conference.yunohost.org et apps@conference.yunohost.org
-ou bien via votre client matrix préféré, à
-#freenode_#yunohost-dev:matrix.org -
+[center] - +[[fa=exclamation-circle /] Rapporter un bug](https://github.com/yunohost/issues/issues?target=_blank&classes=btn,btn-lg,btn-warning) [[fa=comment /] Contacter les développeur.euse.s](https://kiwiirc.com/client/irc.freenode.net/yunohost-dev?target=_blank&classes=btn,btn-lg,btn-warning) +[/center] + +!!! Note : vous pouvez aussi vous connecter aux salons de discussions dev et apps, voir [la page correspondante](/chat_rooms) diff --git a/pages/03.community/03.help/help.md b/pages/03.community/03.help/help.md index c82df5ee..a2722496 100644 --- a/pages/03.community/03.help/help.md +++ b/pages/03.community/03.help/help.md @@ -18,9 +18,9 @@ routes: [/center] !!! **Note:** this room is available via -!!! - IRC (#yunohost on freenode, [using kiwiirc](https://kiwiirc.com/nextclient/?settings=7b72a0a81838360686798199ed53624f&target=blank)) -!!! - XMPP (*support@conference.yunohost.org*) -!!! - Matrix (*#freenode_#yunohost:matrix.org*) [using Riot](https://riot.im/app/#/room/#yunohost:matrix.org?target=_blank)) +!!! - Matrix (`#freenode_#yunohost:matrix.org` [using Element](https://riot.im/app/#/room/#yunohost:matrix.org?target=_blank)) +!!! - IRC (`#yunohost` on freenode, [using kiwiirc](https://kiwiirc.com/nextclient/?settings=7b72a0a81838360686798199ed53624f&target=blank)) +!!! - XMPP (`support@conference.yunohost.org`) ## ... or ask on the forum ! @@ -38,5 +38,4 @@ routes: [/center] -!!! Note : you can also connect to the devrooms using your favorite XMPP client, to dev@conference.yunohost.org and apps@conference.yunohost.org -!!! or with a Matrix client to [#freenode_#yunohost-dev:matrix.org](https://matrix.to/#/#freenode_#yunohost-dev:matrix.org) +!!! Note : you can also connect to the dev and apps chatrooms, see [the corresponding page](/chat_rooms)