Documentation

L'atelier de développement

Ce que l'usine a livré, son coût, ce qui nécessite votre intervention et le déroulement de chaque tâche.

L'usine est l'endroit où vous arrivez après vous être connecté. Elle affiche ce que votre usine a livré et son coût, puis ce qui nécessite votre intervention ; chaque tâche et plan est présenté comme le récit du déroulement du travail. Les Tâches, voies, plans, automatisations et rapports y sont tous accessibles, afin que vous puissiez répondre en un seul endroit à la question « Que avons-nous obtenu et qu'est-ce qui a besoin de moi ? ».

À quoi sert-elle ?

L'usine répond à la question « Qu'a-t-on livré, quel en a été le coût et qu'est-ce qui me concerne ? ». Mission Control, à un clic de distance, répond à « Qu'est-ce qui est en cours d'exécution en ce moment ? ».

La distinction est importante lorsque vous avez plus de quelques tâches en cours. L'usine est l'endroit où vous prenez les décisions ; Mission Control est l'endroit où vous observez.

Vue d'ensemble

Choisissez cette semaine ou ce mois, ainsi qu'un Projet ou Tout sous le titre.

  • Trois chiffres: les demandes de fusion validées, le travail terminé et l'argent dépensé, chacun comparé à la période précédente (« +4 par rapport à la semaine dernière »). Le nombre de demandes de fusion validées compte chaque pull request fusionné dans vos dépôts connectés, quel que soit l'auteur, et indique combien d'éléments ont été traités par Coroid (« 11 par Coroid »). Choisissez un chiffre pour le voir sur les huit dernières semaines ou mois ; le coût par pull request fusionné par Coroid apparaît sous le graphique. Ces chiffres proviennent des enregistrements, jamais d'un modèle.
  • Besoin de vous liste uniquement les décisions à prendre : un plan à approuver, un travail à examiner ou fusionner, un problème de test sans Tâche associée, une demande à accepter, ainsi qu'un travail échoué ou bloqué. Son en-tête indique leur nombre ; les cinq premiers sont affichés, et Afficher plus ajoute le reste. Ouvrez une ligne pour en voir l'action unique, ou mettez-la de côté avec « Pas maintenant ».
  • Projets affiche une ligne par Projet ayant du travail durant la période, avec les éléments fusionnés en premier. Ouvrez une ligne pour voir les chiffres propres au Projet, son travail en cours, savoir si ce qui a été livré fonctionne correctement en production, et comment le travail s'est déroulé : la fréquence à laquelle le contrôle qualité l'a approuvé du premier coup, et le temps nécessaire pour passer de la demande à la livraison. Les Projets sans activité durant la période sont regroupés en une seule ligne (« 4 projets sont inactifs »).
  • Terminé cette semaine liste les résultats, du plus récent au plus ancien ; les exécutions d'automatisation courantes sont regroupées en une seule ligne.
  • Tout le travail ouvre la liste complète des Tâches, voies, plans, automatisations et rapports, classés par statut.

Lorsque le travail est fusionné, utilisez Versions pour suivre la validation sélectionnée, les tentatives de déploiement et l'état de l'environnement. Une tâche terminée ou une voie promue ne constituent pas un résultat de déploiement.

Usine
Cette semainecoroid-expoMes demandesBref aperçu de l'usine
Fusionnées
9
6 more than last week
7 par Coroid
Terminées
7
5 more than last week
Consommées
17,41 $US
376 % more than last week
14 sept.Cette semaine
Nécessite votre intervention10
Sélectionner
  • Upgrade uuid (breaking change) is blockedcoroid-expo · il y a 2 jours
  • Pin our GitHub Actions and let Dependabot keep them current stoppedcoroid-expo · il y a 4 jours
  • Pin our GitHub Actions and let Dependabot keep them current stoppedcoroid-expo · il y a 4 jours
Projets
  • coroid-expo9 fusionnées · 7 terminées · 17,41 $US · 10 en attente de vous

Aperçu de l'usine : les chiffres et le graphique de la semaine, ce qui nécessite votre attention, et une ligne par projet. Données illustratives.

Traiter plusieurs décisions à la fois

Lorsque du travail ancien s'accumule dans Besoin de vous, sélectionnez les lignes ensemble : survolez une ligne pour que son point devienne une case à cocher, ou utilisez Sélectionner à côté de l'en-tête (sur un téléphone). Tout sélectionner sélectionne toutes les lignes. Ensuite :

  • Pas maintenant met les lignes de côté pour vous jusqu'à ce que leur travail change. Les autres les verront toujours.
  • Fermer pour tout le monde (propriétaires et administrateurs) archive les plans, annule les Tâches en attente d'examen et écarte le reste (travail échoué, problèmes de test, demandes) pour toute l'organisation jusqu'à ce que leur travail change. Coroid demande d'abord, et rien n'est supprimé.

Décider d'une fusion

Un plan prêt à être fusionné s'ouvre sur sa décision : le temps qu'il a attendu, ce que la fusion entraîne (« La fusion le placera dans la branche principale de coroid-expo »), une série de faits (ses Tâches, ses vérifications, pull request), ainsi que des sections fermées sur les modifications apportées, tout ce qui mérite d'être su, les preuves et le chemin parcouru. Approuver et fusionner demande une dernière confirmation avant la fusion ; Autres options propose Demander des modifications, Poser une question à ce sujet, pull request et le nom de la branche.

Comment s'est déroulé un travail

Ouvrez une Tâche et elle s'affiche comme son fil de discussion : une phrase sur ce qui s'est passé (ou ce qui se passe actuellement), une ligne de faits (critères remplis, temps, coût, cycles de contrôle qualité), un suivi depuis Demandé, Planifié, Construit, Vérifié jusqu'à Livré, ainsi que les messages qui y ont mené : la demande, chaque ordre de travail, les rapports du développeur et du contrôle qualité, les réponses de votre équipe, et la manière dont cela s'est terminé. Lorsque le contrôle qualité renvoie le travail, ces cycles se replient en une seule ligne que vous pouvez ouvrir.

Choisissez un message pour voir son historique : l'ordre de travail, les vérifications, et l'exécution avec son modèle, ses jetons et son temps, avec un accès au parcours complet. « À propos de ce travail » contient la spécification, la personne qui a demandé, le plan, la qualité et le coût.

Un plan se lit de la même manière : ses phases en tant que carte, chaque Tâche avec son déroulement, et le nombre de Tâches approuvées du premier coup par le contrôle qualité.

Le travail interrompu est indiqué en rouge, avec ce qui est sûr (« Sécurisé : la branche principale n'a pas changé »), la raison de l'interruption (ses derniers messages et l'échec enregistré) et Réessayer maintenant.

À la fin d'un fil de discussion, vous pouvez :

  • Répondre, et mentionner des personnes avec @ ; elles recevront une notification avec un lien.
  • Poser une question à l'assistant concernant le travail. Il lit le fil de discussion pour répondre (« Pourquoi a-t-il été renvoyé ? ») et fournit des liens vers ce qu'il a trouvé.
  • Partager Partagez-le avec les membres de votre organisation ; ils recevront une notification contenant son lien. Personne en dehors de votre organisation ne pourra l'ouvrir.
  • Copier en version courte: un résumé succinct incluant le résultat, les faits et le lien, à coller partout.

Suivre l'exécution d'une tâche

Ouvrez une tâche en cours d'exécution pour la suivre en temps réel : les étapes effectuées, les outils utilisés, les fichiers modifiés et les résultats des tests au fur et à mesure de leur génération.

Il est utile de le faire quelques fois au début. Suivre deux ou trois tâches du début à la fin vous apprendra plus sur la rédaction d'une bonne spécification que n'importe quelle documentation : vous verrez précisément où l'agent a dû faire des suppositions.

Ensuite, arrêtez de suivre l'exécution. Les notifications vous informeront lorsque quelque chose nécessitera votre intervention.

Intervenir

Vous pouvez mettre en pause, annuler ou renvoyer une tâche en cours d'exécution avec des commentaires. Consultez Lorsqu'une tâche est bloquée ou échoue pour savoir quand utiliser chacune d'elles.

Automatisation

Le travail ne commence pas seulement lorsqu'une personne tape une description :

  • Automatisations lancent des tâches selon un calendrier ou en réponse à un événement, comme l'ouverture d'un pull request. Elles sont répertoriées dans la section Automatisations.
  • Calendriers exécutent des tâches de manière récurrente.
  • Hooks réagissent aux événements de la plateforme.
  • Rapports résument ce qui s'est passé, selon un calendrier.

Dans cette section