mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Add troubleshooting general advice page, tweaks in /help
This commit is contained in:
Alexandre Aubin
parent
c05680bc06
commit
a76235b57d
6 changed files with 79 additions and 53 deletions
|
|
@ -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 <small>(ou de votre déité, animal, nourriture préférée)</small>, 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**.
|
||||
|
||||
|
||||
26
pages/01.administrate/08.troubleshooting/troubleshooting.md
Normal file
26
pages/01.administrate/08.troubleshooting/troubleshooting.md
Normal file
|
|
@ -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 <small>(or your favourite deity / animal / food)</small>, 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**.
|
||||
|
||||
|
||||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
title: Administrer
|
||||
title: Guide d'administration
|
||||
template: chapter
|
||||
taxonomy:
|
||||
category: docs
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
title: Administrate
|
||||
title: Admin guide
|
||||
template: chapter
|
||||
taxonomy:
|
||||
category: docs
|
||||
|
|
|
|||
|
|
@ -7,60 +7,35 @@ routes:
|
|||
default: '/help'
|
||||
---
|
||||
|
||||
<h3>Connectez-vous au salon de support</h3>
|
||||
## 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]
|
||||
<iframe src="https://kiwiirc.com/nextclient/?settings=7b72a0a81838360686798199ed53624f" style="width:100%;height:450px;border:0;display:block"></iframe>
|
||||
[/center]
|
||||
|
||||
<iframe src="https://kiwiirc.com/nextclient/?settings=78e5074440caaa9141c9e30629f6b29d" style="width:100%;height:450px;border:0;display:block"></iframe>
|
||||
!!! **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`)
|
||||
|
||||
</br>
|
||||
</br>
|
||||
<em>Note : ce salon est accessible via IRC (#yunohost sur freenode en utilisant <a href="https://kiwiirc.com/nextclient/?settings=78e5074440caaa9141c9e30629f6b29d">Kiwiirc</a>), via XMPP <small>(support@conference.yunohost.org)</small>, ou Matrix <small>(#freenode_#yunohost:matrix.org - <a target="_blank" href="https://app.element.io/#/room/#yunohost:matrix.org">en utilisant Element</a>)</small>.</em>
|
||||
</center>
|
||||
## ... or ask on the forum !
|
||||
|
||||
<h3>... ou demandez sur le forum !</h3>
|
||||
[center]
|
||||
[[fa=comment /] Aller sur le forum](https://forum.yunohost.org/?target=_blank&classes=btn,btn-lg,btn-success)
|
||||
[/center]
|
||||
|
||||
<center>
|
||||
<button id="goForum" type="button" class="btn btn-success" style="font-weight:bold;">
|
||||
<span class="glyphicon glyphicon-comment"></span> Aller sur le forum
|
||||
</button>
|
||||
</center>
|
||||
## You've found a bug ?
|
||||
|
||||
<h3>Vous avez trouvé un bug ?</h3>
|
||||
!!!! Please report bugs on our bugtracker or contact the developers
|
||||
|
||||
<center>
|
||||
<br>
|
||||
<em>Vous pouvez rapporter le bug sur le bugtracker ou contacter les développeurs</em><br><br>
|
||||
<button id="goBugtracker" type="button" class="btn btn-warning" style="font-weight:bold;">
|
||||
<span class="glyphicon glyphicon-exclamation-sign"></span> Rapporter un bug
|
||||
</button>
|
||||
<button id="goDevroom" type="button" class="btn btn-warning" style="font-weight:bold; margin-left:40px">
|
||||
<span class="glyphicon glyphicon-comment"></span> Contacter les développeurs
|
||||
</button>
|
||||
</br>
|
||||
</br>
|
||||
<em>Note : vous pouvez aussi vous connecter aux salons de dev, via votre client XMPP favori, à</br>
|
||||
dev@conference.yunohost.org et apps@conference.yunohost.org</br>
|
||||
ou bien via votre client matrix préféré, à</br>
|
||||
#freenode_#yunohost-dev:matrix.org</em>
|
||||
</center>
|
||||
[center]
|
||||
|
||||
<script>
|
||||
document.getElementById("goForum").onclick = function() {
|
||||
window.location.href = "https://forum.yunohost.org/latest";
|
||||
}
|
||||
document.getElementById("goBugtracker").onclick = function() {
|
||||
window.location.href = "https://github.com/yunohost/issues/issues";
|
||||
}
|
||||
document.getElementById("goDevroom").onclick = function() {
|
||||
window.location.href = "https://kiwiirc.com/client/irc.freenode.net/yunohost-dev";
|
||||
}
|
||||
document.getElementById("goForum").onclick = function() {
|
||||
window.location.href = "https://forum.yunohost.org";
|
||||
}
|
||||
</script>
|
||||
[[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)
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue