Contacter

Soutien

Différents types de questions ou de discussions correspondent à différentes voies de communication ; Vérifiez les descriptions ci-dessous pour vous assurer de choisir la bonne méthode.

Besoin d’aide pour dépanner votre système ? Tout d’abord, recherchez ROS Answers pour voir si d’autres ont eu des problèmes similaires et si leur solution fonctionne pour vous.

Sinon, posez une nouvelle question sur ROS Answers. Assurez-vous d’ajouter des balises, au moins la balise ros2 et la version de distribution que vous utilisez, par ex. humble. Si votre question est liée à la documentation ici, ajoutez une balise comme docs, ou plus précisément, tutoriels.

Appui contributif

Les utilisateurs de ROS 2 proviennent d’un large éventail de formations techniques, utilisent une variété de systèmes d’exploitation différents et n’ont pas nécessairement d’expérience préalable avec ROS (1 ou 2). Il est donc important que les utilisateurs, quelle que soit leur expérience, contribuent au support.

Si vous voyez un problème sur ROS Answers qui ressemble à quelque chose que vous avez rencontré vous-même, veuillez envisager de fournir quelques indications sur ce qui vous a aidé à ta situation. Ne vous inquiétez pas si vous n’êtes pas sûr que votre réponse soit correcte. Dites-le simplement et d’autres membres de la communauté interviendront si nécessaire.

Problèmes

Si vous identifiez des bogues, avez des suggestions d’améliorations ou une question spécifique à un package, vous pouvez ouvrir un problème sur GitHub.

Par exemple, si vous suivez les tutoriels ici et rencontrez une instruction qui ne fonctionne pas sur votre système, vous pouvez ouvrir un problème dans la ros2_documentation dépôt.

Vous pouvez rechercher des référentiels ROS 2 individuels sur le GitHub de ROS 2.

Avant d’ouvrir un problème, vérifiez si d’autres utilisateurs ont signalé des problèmes similaires en effectuant une recherche dans les organisations ros2 et ament GitHub : example search query.

Ensuite, consultez ROS Answers pour voir si quelqu’un d’autre a posé votre question ou signalé votre problème.

S’il n’a pas été signalé, n’hésitez pas à ouvrir un problème dans le tracker de référentiel approprié. Si vous ne savez pas quel tracker utiliser pour un problème particulier, déposez-le dans le référentiel ros2/ros2 et nous l’examinerons.

Lorsque vous signalez un problème, assurez-vous de :

  • Incluez suffisamment d’informations pour qu’une autre personne comprenne le problème.

Décrivez exactement ce que vous faisiez ou essayez de faire, et ce qui, le cas échéant, n’a pas fonctionné. Si vous suivez un didacticiel ou des instructions en ligne, fournissez un lien vers les instructions spécifiques.

  • Utilisez un titre descriptif ou une ligne d’objet. Mauvais : « rviz ne fonctionne pas ». Bon : « Rviz plante à la recherche d’un fichier .so manquant après la dernière mise à jour d’apt »

  • Incluez des informations sur la plate-forme exacte, les logiciels, les versions et l’environnement pertinents pour le problème. Cela inclut la manière dont vous avez installé le logiciel (à partir des fichiers binaires ou de la source) et le fournisseur de middleware/DDS ROS que vous utilisez (si vous le connaissez).

  • Tout avertissement ou erreur. Coupez-les et collez-les directement depuis la fenêtre du terminal sur laquelle ils ont été imprimés. Veuillez ne pas retaper ou inclure une capture d’écran.

  • En cas de bogue, envisagez de fournir un exemple court, autonome et correct (compilable).

  • Lorsque vous discutez de problèmes de compilation/liaison/installation, fournissez également la version du compilateur

Le cas échéant, incluez également votre :

  • ROS environment variables (env | grep ROS)

  • Backtraces

  • Fichiers de configuration pertinents

  • Modèle de carte graphique et version du pilote

  • Ogre.log pour rviz, si possible (exécuter avec rviz -l)

  • Fichiers de sac et exemples de code pouvant reproduire le problème

  • Gifs ou films pour illustrer le problème

Demandes d’extraction

Lorsque vous vous sentez suffisamment à l’aise pour suggérer une modification spécifique directement au code, vous pouvez soumettre une demande d’extraction. Les demandes d’extraction sont les bienvenues pour tous les dépôts ros2. Voir la page Contributing pour plus de détails et l’étiquette sur la façon de contribuer.

Discussion

Pour démarrer une discussion avec d’autres membres de la communauté ROS 2, visitez le discourse ROS officiel. Le contenu du discours doit être de haut niveau ; ce n’est pas un endroit pour obtenir des réponses à des questions sur le code, mais il conviendrait d’entamer une conversation sur les meilleures pratiques ou l’amélioration des normes.

Des discussions sur le développement et les plans de ROS 2 se déroulent dans la catégorie de discours « Next Generation ROS » <https://discourse.ros.org/c/ng-ros>`__. Participer à ces discussions est un moyen important d’avoir son mot à dire sur la façon dont les différentes fonctionnalités de ROS 2 fonctionneront et seront mises en œuvre.

La communauté diversifiée derrière l’écosystème ROS est l’un de ses plus grands atouts. Nous encourageons tous les membres de la communauté ROS à participer à ces discussions de conception afin que nous puissions tirer parti de l’expérience des membres de la communauté et garder à l’esprit les divers cas d’utilisation de ROS.

Étiquette

Présumez de la « bonne foi » : il est facile de mal interpréter le sens ou le ton des commentaires sur Internet. En supposant que la bonne foi donne le bénéfice du doute à ceux qui essaient de vous aider, en évitant : d’insulter des membres bien intentionnés de la communauté et d’empoisonner l’ambiance. Présumer de la «bonne foi» lors de la réponse fonctionne presque toujours mieux même si la réponse initiale n’était en fait pas de bonne foi.

Veuillez ne pas envoyer votre question plus d’une fois : la question a été vue. Si vous n’avez pas reçu de réponse, personne n’a probablement eu le temps de vous répondre. Alternativement, il se pourrait que personne ne connaisse la réponse. En tout cas, le renvoyer est une mauvaise forme et s’apparente à des cris et risque d’agacer un grand nombre de personnes. Ceci s’applique également au crossposting. Essayez de choisir le forum qui, selon vous, correspond le mieux et posez-y la question. Si vous êtes redirigé vers un nouveau forum, fournissez un lien vers l’ancienne discussion.

Sur https://answers.ros.org, vous pouvez modifier votre question pour fournir plus de détails. Plus vous incluez de détails dans votre question, plus il est facile pour les autres de vous aider à trouver votre solution, ce qui vous donne plus de chances d’obtenir une réponse.

Il est considéré comme une mauvaise forme d’énumérer vos échéances personnelles ; les membres de la communauté qui répondent aux questions les ont également.

Ne mendiez pas de l’aide. S’il y a quelqu’un désireux et capable de vous aider à résoudre votre problème, vous obtenez généralement une réponse. Demander des réponses plus rapides aura surtout un effet négatif.

N’ajoutez pas de contenu non lié aux publications. Le contenu des messages doit être axé sur le sujet traité et ne pas inclure de contenu sans rapport. Le contenu, les liens et les images sans rapport avec le sujet sont considérés comme du spam.

Pour les publications commerciales, voir également cette discussion.

Minimisez les références au contenu derrière les murs payants. Le contenu publié sur ROS Discourse et ROS Answers devrait « généralement » être gratuit et ouvert à tous les utilisateurs . Les liens vers du contenu derrière des murs payants tels que des articles de journaux privés, des manuels et des sites Web d’actualités payants, bien qu’utiles et pertinents, peuvent ne pas être accessibles à tous les utilisateurs. Dans la mesure du possible, les sources primaires doivent être gratuites et ouvertes, le contenu payant jouant un rôle de soutien.

Les publications à lien unique sont à éviter. D’une manière générale, la publication d’un seul lien de réponse est moins utile et peut facilement être confondue avec du spam. De plus, les liens peuvent se dégrader avec le temps ou être remplacés. Paraphraser le contenu d’un lien avec certaines informations contextuelles et l’attribution est souvent beaucoup plus utile.

Contact privé

Si vous souhaitez nous contacter en privé (par exemple, si votre question contient des informations sensibles pour votre organisation ou votre projet, ou si elle concerne un problème de sécurité), vous pouvez nous envoyer un e-mail directement à ros@osrfoundation.org.