From 6871ae7e0359e4cd2292ec10fb15573a31993227 Mon Sep 17 00:00:00 2001 From: tituspijean Date: Fri, 30 Dec 2022 16:06:14 +0100 Subject: [PATCH] Add a section on how to ask for help --- pages/05.community/15.help/help.fr.md | 21 +++++++++++++++++---- pages/05.community/15.help/help.md | 21 +++++++++++++++++---- 2 files changed, 34 insertions(+), 8 deletions(-) diff --git a/pages/05.community/15.help/help.fr.md b/pages/05.community/15.help/help.fr.md index f29e3271..7cbbfaa5 100644 --- a/pages/05.community/15.help/help.fr.md +++ b/pages/05.community/15.help/help.fr.md @@ -7,12 +7,23 @@ routes: default: '/help' --- +## Comment demander de l'aide + +[columns count=2 width=200px] +!!!! - **Soyez courtois**: l'aide dans le salon de discussion ou le forum est prodiguée par nos utilisateurs ou contributeurs, tous bénévoles. +!!!! - **Exposez le contexte** de votre demande de manière complète mais concise. +!!!! - Il est impératif de **partager les journaux d'erreur (*log*) avec YunoPaste** (boutons verts de votre webadmin, puis partagez l'adresse de la page générée). +!!!! - **Soyez patient**, vos messages ne seront peut-être pas vus immédiatement. + +!! - Ne demandez pas d'aide sur votre tentative de solution, présentez avant tout votre problème initial (cf. [Problème XY](https://xyproblem.info/) (en anglais)). +!! - Evitez les formulations du type "le serveur ne veut pas", "l'app ne se charge pas", ou autres descriptions vides de sens. +!! - Ne tronquez pas les messages d'erreur, mais ne copiez pas non plus un pavé de code illisible ou sans formatage. (Utilisez [YunoPaste](https://paste.yunohost.org)) +!! - Ne tournez pas votre question comme un sondage ("est-ce que quelqu'un a réussi à...?"). +[/columns] + ## Connectez-vous au salon de support -!!! **Conseils de pros™** -!!! - Ne demandez pas si vous pouvez demander, demandez directement ! -!!! - *Soyez patient*, vos messages ne seront peut-être pas vus immédiatement. -!!! - Pensez à partager les logs avec YunoPaste ! +S'il vous plaît, changez votre pseudo, nous avons des légions de `ynhuser`s. [center] @@ -25,6 +36,8 @@ routes: ## ... ou demandez sur le forum ! +S'il vous plaît, suivez le canevas des messages de la section Support. Cela aide tout le monde à comprendre le contexte de votre demande. + [center] [[fa=comment /] Aller sur le forum](https://forum.yunohost.org/?target=_blank&classes=btn,btn-lg,btn-success) [/center] diff --git a/pages/05.community/15.help/help.md b/pages/05.community/15.help/help.md index 478cd776..35df1a73 100644 --- a/pages/05.community/15.help/help.md +++ b/pages/05.community/15.help/help.md @@ -7,12 +7,23 @@ routes: default: '/help' --- +## How to ask for help + +[columns count=2 width=200px] +!!!! - **Be courteous**: help in the chatrooms or on the forum is given by our users and contributors, all volunteers. +!!!! - **Explain the context** of your request in a complete but concise way. +!!!! - It is paramount to **share the error logs with YunoPaste** (green buttons in your webadmin, then share the link to the generated page). +!!!! - **Be patient**, as your messages might not be seen instantly. + +!! - Do not ask about your attempted solution but rather your actual problem (see [XY problem](https://xyproblem.info/)). +!! - Avoid phrases like "server does not want", "the app does not load", or other meaningless sentences. +!! - Do not trim error messages, but do not paste a wall of illegible unformatted code either. (Use [YunoPaste](https://paste.yunohost.org)) +!! - Do not ask your question like a poll ("does anyone else succeeded in...?"). +[/columns] + ## Connect to the support chatroom -!!! **ProTips™** -!!! - Don't ask to ask, just ask ! -!!! - *Be patient*, it can take a few minutes before someone sees your messages. -!!! - Please share the logs with YunoPaste ! +Please change your username, as we got legions of `ynhuser`s. [center] @@ -25,6 +36,8 @@ routes: ## ... or ask on the forum ! +Please follow the Support section post template. It helps everyone understand the context of your request. + [center] [[fa=comment /] Go to the forum](https://forum.yunohost.org/?target=_blank&classes=btn,btn-lg,btn-success) [/center]