Lorsque vous rencontrez un problème avec Open Rails (ORTS), quel qu'il soit, l'équipe de développement OR est toujours reconnaissante pour les rapports de bogues possibles. Bien sûr, c'est aux développeurs de décider si quelque chose est un vrai bogue, mais dans tous les cas, votre signalement est une étape importante pour aider l'équipe de développement à améliorer Open Rails.
L'équipe de développement utilise deux méthodes pour suivre les bogues :
1. Les soi-disant "Maybe-Bugs" sont signalés dans un simple message sur le forum : voir le paragraphe suivant pour les liens. Ceci est fait afin de donner aux développeurs une chance de filtrer les problèmes causés par des circonstances que l'équipe de développement ne peut pas contrôler, telles que le contenu corrompu.
2. Les bogues décidés sont des problèmes qu'un développeur a examinés et qui ont trouvé qu'il s'agissait d'un problème réel dans le code de programme d'Open Rails. Ils sont signalés sur notre Bug Tracker à https://bugs.Launchpad.net/ou/(l'inscription est requise).
Si vous rencontrez un problème avec Open Rails, vous devez d'abord déposer un rapport Maybe-Bug sur l'un des forums suivants surveillés par l'équipe de développement d'Open Rails :
• Elvas Tower, section "Peut-être que c'est un bug" du sous-forum Open Rails. Il s'agit du forum le plus fréquemment consulté par l'équipe de développement OR ;
• TrainSim.com, section "Open Rails discussion" du sous-forum Open Rails
• . . .plus de forums peuvent être ajoutés à l'avenir
Un rapport Maybe-Bug consiste en un simple message dans un nouveau sujet du forum. Le titre du sujet doit être de la forme "Open Rails V#### Bug : +++++", où #### est le numéro de version de la version d'Open Rails avec laquelle vous rencontrez des problèmes, et ++ +++ est une description rapide du problème que vous rencontrez. Ce format aide les développeurs à se faire une idée rapide du problème signalé.
Le premier message de ce nouveau sujet devrait donner plus d'informations sur votre problème : commencez par définir exactement le problème que vous rencontrez, décrivez-le dans un récit et complétez cette description avec des captures d'écran, des messages d'erreur produits par Open Rails, etc.
Ensuite, indiquez clairement le contenu que vous utilisiez (c'est-à-dire : itinéraire, activité, chemin, composition, locomotive et matériel roulant ; selon le cas), s'il s'agit d'un logiciel gratuit ou payant, quel était le nom exact du package téléchargé et où il peut être obtenu. Bien sûr, publier un lien de téléchargement vers un site digne de confiance ou joindre directement des fichiers à la publication est également acceptable.
Continuez avec une description exacte de ce que vous faisiez lorsque le problème est survenu (cela peut déjà être inclus dans le premier paragraphe, si le problème est lié à l'exploitation du train). Encore une fois, des captures d'écran, etc. peuvent être utiles pour mieux décrire la situation.
Enfin, jetez un coup d'œil sur votre bureau pour un fichier texte intitulé OpenRailsLog.txt. Téléchargez et joignez ce fichier à la fin de votre message. Ceci est très important car le fichier journal contient toutes les données de programme pertinentes que l'utilisateur n'a aucune chance de voir, et c'est donc l'une des sources d'informations les plus importantes pour le développeur essayant de résoudre votre problème.
Une fois que votre message a été soumis, continuez à ajouter des informations supplémentaires uniquement dans des messages supplémentaires, afin d'éviter le risque que les personnes ne remarquent pas vos modifications. Veuillez également être patient avec les développeurs qui répondent à votre rapport. La plupart des forums ne sont vérifiés qu'une fois par jour, il peut donc falloir un certain temps à un développeur pour voir votre rapport.
Important : plus un développeur obtient d'informations dès le premier message, plus il sera en mesure de localiser, d'identifier et éventuellement de résoudre un bogue rapidement. D'autre part, les rapports du formulaire, "J'ai un problème XYZ avec Open Rails récemment installé. Pouvez-vous m'aider?" sont de peu d'utilité, car toutes les informations requises doivent être demandées en premier.
Important : ne vous précipitez pas pour signaler un bogue décidé sur le suivi des bogues avant qu'un développeur n'ait déclaré votre problème comme un vrai bogue !
La description ci-dessus est disponible sous forme de « liste de contrôle » condensée ci-dessous.
De nombreux rapports de bogue n'atteignent même jamais le statut de bogue décidé, étant une erreur de contenu ou d'utilisateur. Certains Maybe-Bugs, cependant, finiront par être déclarés Bugs décidés. Ces bogues sécurisés doivent être signalés à notre Bug Tracker, lorsque le développeur qui prend le rapport vous le demande également.
L'Open Rails Bug Tracker se trouve sur https://bugs.Launchpad.net/or/, en suivant le lien "Signaler un bug" dans la moitié supérieure à droite de l'écran. Vous devrez vous inscrire sur Launchpad pour pouvoir signaler un bogue.
Une fois cela fait, suivez les étapes que le logiciel vous guide : Dans "Résumé", copiez et collez la description rapide du bogue que vous avez également saisie comme nom de fil de discussion du forum pour le rapport Maybe-Bug.
Ensuite, parcourez la liste des sujets auxquels Launchpad pense que votre bogue peut être lié – peut-être que votre problème a déjà été signalé ?
Si vous ne pouvez vous identifier à aucun des bogues suggérés, cliquez sur le bouton "Non, j'ai besoin d'un nouveau rapport de bogue" et continuez.
Dans le champ "Informations complémentaires", entrez les mêmes informations que vous avez également fournies dans le rapport Maybe-Bug (copier et coller). Des captures d'écran devront peut-être être ajoutées en pièces jointes, et vous devrez également télécharger à nouveau le fichier OpenRailsLog.txt. N'oubliez pas d'inclure toutes les informations que vous avez ajoutées dans des messages supplémentaires au rapport original de Maybe-Bug, et ajoutez également un lien vers ce dernier au bas du champ "Informations complémentaires".
Une fois que votre bogue a été soumis, continuez à ajouter des informations supplémentaires uniquement dans des messages supplémentaires, afin d'éviter le risque que les développeurs manquent les informations supplémentaires.
La description ci-dessus est disponible sous forme de « liste de contrôle » condensée ci-dessous.
Important : Ne dites pas "Toutes les informations sont incluses dans le fil de discussion lié", car parcourir un fil de discussion à la recherche de l'information cruciale est une tâche vraiment ennuyeuse. Au lieu de cela, veuillez fournir un résumé concis mais complet du fil de discussion Maybe-Bug dans le champ "Informations complémentaires".
Important : ne vous précipitez pas pour signaler un bogue résolu sur notre outil de suivi des bogues avant qu'un développeur n'ait déclaré votre bogue peut-être comme un vrai bogue !
Veuillez ne pas publier de demandes de fonctionnalités en tant que Maybe-Bug dans le Bug Tracker sur Launchpad !
Veuillez ne pas signaler le même bogue plusieurs fois, simplement parce que le premier rapport n'a pas attiré l'attention dans un court laps de temps. Trier la confusion qui en résulte peut ralentir encore plus les choses.
Veuillez ne pas signaler les bogues directement au Bug Tracker lorsque vous n'êtes pas sûr à 100 % qu'il s'agit d'un bogue réel et important, ou qu'on ne vous a pas demandé de le faire.
Ne soyez pas offensé par les statuts de bogue - ils sonnent souvent plus durs qu'ils ne le signifient vraiment, comme "Invalide".
Ne vous attendez pas à une réponse rapide en général - les problèmes seront examinés au fur et à mesure que les gens en auront le temps.
Soyez prêt à développer le rapport initial - il est remarquablement facile d'oublier certains détails cruciaux dont d'autres ont besoin pour trouver et corriger votre bogue, alors attendez-vous à ce qu'on vous pose d'autres questions avant que le travail puisse commencer.
Essayez d'éviter les commentaires qui n'ajoutent aucun détail technique ou pertinent - si vous souhaitez enregistrer que le bogue vous affecte, Launchpad a un bouton dédié en haut : "Ce bogue vous affecte-t-il ?".
Si vous souhaitez suivre la progression du rapport de bogue de quelqu'un d'autre et recevoir des notifications par e-mail, vous pouvez vous abonner au courrier de bogue à partir de la barre latérale.
"Peut-être-Bug"
• Nouveau sujet dans le sous-forum approprié
• Titre du sujet : "Bogue Open Rails V<version> : <description>"
• Description du problème, complétée par des captures d'écran, etc.
• Contenu utilisé (itinéraire, activité, chemin, composition, locomotive et matériel roulant ; choisissez applicable ); Logiciels gratuits/payants ? ; Nom du package et emplacement de téléchargement / lien de téléchargement
• Récit des actions peu avant et au moment du problème, complété par des captures d'écran, etc.
• Joindre un fichier journal (bureau : OpenRailsLog.txt)
• Ajouter des informations supplémentaires uniquement dans les messages supplémentaires
• Être patient
Bug décidé
• Signaler à Bug Tracker uniquement si on vous le demande
• https://bugs.Launchpad.net/or/ (inscription requise) -> "Signaler un bug"
• "Résumé" : description tirée du titre du sujet du rapport Maybe-Bug
• Rechercher des bogues similaires déjà signalés
• Condensez tout le fil de discussion Maybe-Bug dans le champ "Plus d'informations"
• Ajouter un lien vers le rapport original Maybe-Bug
• Téléchargez à nouveau et joignez OpenRailsLog.txt et des captures d'écran explicatives, etc.
• Ajouter des informations supplémentaires uniquement dans les messages supplémentaires
• Être patient
• Nouveau – c'est là que commencent tous les bogues. À ce stade, le bogue n'a pas été examiné par les bonnes personnes pour vérifier s'il est complet ou si plus de détails sont nécessaires.
• Incomplet – un membre des équipes Open Rails a décidé que le bogue avait besoin de plus d'informations avant de pouvoir être corrigé. La personne qui a créé le rapport de bogue n'a pas besoin d'être celle qui fournit les détails supplémentaires. Un bug resté incomplet pendant 60 jours consécutifs est automatiquement supprimé.
• Opinion - le bogue a été identifié comme une opinion, ce qui signifie qu'il n'est pas clair s'il y a réellement un bogue ou comment les choses devraient se comporter.
• Invalide – un membre de l'équipe pense que le rapport n'est pas réellement un rapport de bogue. Cela peut être dû au fait qu'Open Rails fonctionne comme prévu et prévu ou qu'il s'agit simplement de spam. Le bogue peut être remis au nouvel état si des informations supplémentaires ou des éclaircissements sont fournis dans les commentaires.
• Ne sera pas corrigé - un membre de l'équipe a décidé que ce bogue ne serait pas corrigé pour le moment. Si le rapport de bogue est une "demande de fonctionnalité", alors ils ont décidé que la fonctionnalité n'est pas souhaitée pour le moment. Ce statut ne signifie pas que quelque chose ne se produira jamais, mais généralement une meilleure raison de corriger le bogue ou d'ajouter la fonctionnalité sera d'abord nécessaire.
• Confirmé - un membre de l'équipe a également pu rencontrer le bogue en suivant les instructions du rapport de bogue.
• Trié – un membre de l'équipe a attribué le niveau d'importance au bogue ou l'a attribué à une étape spécifique. Les bogues doivent généralement arriver à cet état avant que les développeurs ne veuillent les examiner en détail.
• En cours – un ou plusieurs membres de l'équipe planifient ou travaillent actuellement sur le rapport de bogue. Ils seront identifiés par le champ cessionnaire.
• Correction validée – la correction du rapport de bogue ou de la demande de fonctionnalité a été effectuée et enregistrée dans le système de contrôle source, Subversion. Une fois sur place, le correctif apparaîtra généralement dans la prochaine version expérimentale.
• Correctif publié – Le code contenant le correctif de bogue a été publié dans une version officielle.
Le fait d'avoir publié un rapport de bogue dans un forum ou dans Launchpad ne génère aucune obligation, responsabilité ou engagement pour l'équipe de développement OR d'examiner et de corriger le bogue. L'équipe de développement OR décide si elle examinera et corrigera le bogue sur une base totalement volontaire et autonome.