Demander de l'aide

La communauté de Superpowers est composée de gens passionnés comme vous, avides de partager leur expérience. Cette page contient quelques conseils pour communiquer de façon efficace. Vous trouverez une liste d'endroits où demander de l'aide à la fin.

Rapporter un bug

Pour que quelqu'un puisse corriger le bug que vous rencontrez, il faut d'abord qu'il puisse le reproduire. Votre but en rapportant un bug devrait être de fournir autant d'informations précises et pertinentes que possible.

1. Commencez par indiquer la version de Superpowers que vous utilisez (en précisant si vous utilisez la version stable ou de développement), et la plateforme sur laquelle vous l'exécutez (le système d'exploitation, si vous êtes dans l'application Superpowers ou dans un navigateur et sa version).

2. Poursuivez en décrivant le problème en quelques mots, en expliquant quel était le comportement que vous attendiez, et ce qu'il s'est passé à la place.

3. Décrivez les étapes que vous avez suivies pour obtenir le bug. Fournissez des captures d'écran si vous pensez qu'elles seront utiles.

4. Si vous rencontrez un message d'erreur, assurez-vous de le copier dans son intégralité, et de noter quand et où elle est survenue. Quand vous rencontrez un bug sérieux, des messages d'erreur peuvent apparaître dans l'onglet Console des outils de développement (accessibles avec F12), donc assurez-vous de vérifier à cet endroit.

Vous pouvez contribuer à isoler le problème en essayant de le reproduire dans un nouveau projet minimal. Si le problème est difficile à reproduire ou requiert un grand nombre d'étapes, fournir une archive ZIP d'un projet minimal qui expose le problème peut être très utile.

Obtenir de l'aide sur le scripting

Lorsque vous êtes concentré sur un problème de scripting, il est facile d'oublier que les autres n'ont pas le même contexte que vous.

Lorsque vous demandez de l'aide, décrivez d'abord votre objectif (la vue d'ensemble de ce que vous essayez d'accomplir). Demander de l'aide sur l'approche spécifique que vous essayez empêchera les autres de vous aider efficacement. Bien sûr, il est utile de mentionner ce que vous avez essayé, mais seulement après avoir clarifié ce que vous aimeriez accomplir.

Lorsque vous partagez du code, ne partagez pas qu'une seule ligne, fournissez suffisamment de contexte pour que votre portion de code fasse sens par elle-même.

Endroits où demander de l'aide

Le forum Superpowers sur Reddit est le meilleur endroit pour demander de l'aide (ainsi que pour partager vos projets, bugs ou suggestions !). Alternativement, vous pouvez utiliser le groupe Skype si vous pensez que l'aide en temps réel est plus adaptée.

Oh, et quand vous faites un truc cool, partagez-le avec @SuperpowersDev sur Twitter, nous serons heureux de vous retweeter !