Add a section on how to ask for help (#2180)

This commit is contained in:
tituspijean 2023-01-03 12:20:35 +01:00 committed by GitHub
parent 6d706676aa
commit cdb6e046df
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 34 additions and 8 deletions

View file

@ -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]
<iframe src="https://kiwiirc.com/nextclient/?settings=d7be8b3b102382f81da862419a65c9b1" style="width:100%;height:450px;border:0;display:block"></iframe>
@ -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]

View file

@ -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]
<iframe src="https://kiwiirc.com/nextclient/?settings=d7be8b3b102382f81da862419a65c9b1" style="width:100%;height:450px;border:0;display:block"></iframe>
@ -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]