7. Documentation contributeur

7.1. Vous rencontrez des dysfonctionnements

7.1.1. À l’usage de la clef liveUSB

  1. Assurez-vous d’avoir lu Documentation utilisateur
  2. Connectez-vous à FramaGit (ouvrir un compte si besoin)
  3. Rendez-vous dans l’espace de gestion des incidents
  4. Recherchez dans l’ensemble des issues ouvertes et fermées si quelqu’un n’a pas déjà rencontré votre dysfonctionnement (utilisez le champ de recherche en haut à droite de la liste pour effectuer une recherche plein texte)
  5. Si à ce stade vous n’avez trouvé d’informations satisfaisantes alors vous allez devoir rédiger une nouvelle issue afin de nous rendre compte de votre situation et du dysfonctionnement :
    1. Accédez à la page de création d’une nouvelle issue
    2. Renseignez le champ Title d’une phrase très courte décrivant le problème comme par exemple : “le pointeur de souris ne s’affiche”
    3. Renseignez le champ Description d’une description détaillée décrivant le problème, avec les éléments minimum suivants :
      • le modèle de votre machine
      • la quantité de mémoire vive (RAM exprimée en Go)
      • le modèle du CPU (ex : Dual Core i5-2450M@2.4GHz)
      • la version de liveUSB touchée par ce dysfonctionnement
      • la description de la méthode pour reproduire le dysfonctionnement
      • une proposition de correction ou d’amélioration (optionnel)
    4. Renseigner le champ Labels à :
      • err: boot si le dysfonctionnement empêche le démarrage du système liveUSB
      • err: system si le dysfonctionnement survient une fois le système liveUSB démarré
    5. Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement

NE PAS RENSEIGNER les champs Assignee et Milestone

7.1.2. Lors de la distribution d’une clef liveUSB

  1. Assurez-vous d’avoir lu Documentation distributeur
  2. Connectez-vous à FramaGit (ouvrir un compte si besoin)
  3. Rendez-vous dans l’espace de gestion des incidents
  4. Recherchez dans l’ensemble des issues ouvertes et fermées si quelqu’un n’a pas déjà rencontré votre dysfonctionnement (utilisez le champ de recherche en haut à droite de la liste pour effectuer une recherche plein texte)
  5. Si à ce stade vous n’avez trouvé d’informations satisfaisantes alors vous allez devoir rédiger une nouvelle issue afin de nous rendre compte de votre situation et du dysfonctionnement :
    1. Accédez à la page de création d’une nouvelle issue
    2. Renseignez le champ Title d’une phrase très courte décrivant le problème comme par exemple : “la partition de persistance ne se créée pas”
    3. Renseignez le champ Description d’une description détaillée décrivant le problème, avec les éléments minimum suivants :
      • le modèle de votre machine
      • la quantité de mémoire vive (RAM exprimée en Go)
      • le modèle du CPU (ex : Dual Core i5-2450M@2.4GHz)
      • la version de liveUSB touchée par ce dysfonctionnement
      • la description de la méthode pour reproduire le dysfonctionnement
      • une proposition de correction ou d’amélioration (optionnel)
    4. Renseigner le champ Labels à err: distribuer
    5. Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement

NE PAS RENSEIGNER les champs Assignee et Milestone

7.1.3. Lors de la construction d’un système liveUSB

  1. Assurez-vous d’avoir lu Documentation constructeur
  2. Connectez-vous à FramaGit (ouvrir un compte si besoin)
  3. Rendez-vous dans l’espace de gestion des incidents
  4. Recherchez dans l’ensemble des issues ouvertes et fermées si quelqu’un n’a pas déjà rencontré votre dysfonctionnement (utilisez le champ de recherche en haut à droite de la liste pour effectuer une recherche plein texte)
  5. Si à ce stade vous n’avez trouvé d’informations satisfaisantes alors vous allez devoir rédiger une nouvelle issue afin de nous rendre compte de votre situation et du dysfonctionnement :
    1. Accédez à la page de création d’une nouvelle issue
    2. Renseignez le champ Title d’une phrase très courte décrivant le problème comme par exemple : “la partition de persistance ne se créée pas”
    3. Renseignez le champ Description d’une description détaillée décrivant le problème, avec les éléments minimum suivants :
      • le modèle de votre machine
      • la quantité de mémoire vive (RAM exprimée en Go)
      • le modèle du CPU (ex : Dual Core i5-2450M@2.4GHz)
      • la version de liveUSB touchée par ce dysfonctionnement
      • la description de la méthode pour reproduire le dysfonctionnement
      • une proposition de correction ou d’amélioration (optionnel)
    4. Renseigner le champ Labels à err: build
    5. Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement

NE PAS RENSEIGNER les champs Assignee et Milestone

7.2. Vous ne trouvez pas la documentation adaptée à votre besoin

  1. Assurez-vous d’avoir lu Documentation liveUSB v0.1
  2. Connectez-vous à FramaGit (ouvrir un compte si besoin)
  3. Rendez-vous dans l’espace de gestion des incidents
  4. Recherchez dans l’ensemble des issues ouvertes et fermées si quelqu’un n’a pas déjà évoqué ce manque documentaire (utilisez le champ de recherche en haut à droite de la liste pour effectuer une recherche plein texte)
  5. Si à ce stade vous n’avez trouvé d’informations satisfaisantes alors vous allez devoir rédiger une nouvelle issue afin de nous rendre compte de votre situation et du manque documentaire :
    1. Accédez à la page de création d’une nouvelle issue
    2. Renseignez le champ Title d’une phrase très courte décrivant le problème comme par exemple : “pas de documentation sur les participantsd au projet”
    3. Renseignez le champ Description d’une description détaillée décrivant le manque documentaire, avec les éléments minimum suivants :
      • le modèle de votre machine
      • la quantité de mémoire vive (RAM exprimée en Go)
      • le modèle du CPU (ex : Dual Core i5-2450M@2.4GHz)
      • la version de liveUSB touchée par ce manque documentaire
      • la description de la documentation absente
      • où placeriez-vous cette documentation ?
      • une proposition de correction ou d’amélioration (optionnel)
    4. Renseigner le champ Labels à étape: documentation
    5. Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement

NE PAS RENSEIGNER les champs Assignee et Milestone

7.3. Vous voulez apporter votre aide, votre savoir-faire ou votre expertise

Lisez avant tout le diagramme Structure de travail et répartition des rôles afin de vous assurer du nom du rôle ou de la tâche que vous proposez.

7.3.1. Vous voulez participer à la rédaction de la documentation

  1. Assurez-vous d’avoir lu Structure de travail et répartition des rôles et Vous ne trouvez pas la documentation adaptée à votre besoin
  2. Connectez-vous à FramaGit (ouvrir un compte si besoin)
  3. Rendez-vous dans l’espace de gestion des incidents
  4. Accédez à la page de création d’une nouvelle issue
  5. Renseignez le champ Title d’une phrase très courte décrivant votre proposition : “documenter l’étape de test d’une version RC”
  6. Renseignez le champ Description d’une description détaillée décrivant votre proposition documentaire, avec les éléments minimum suivants :
    • le modèle de votre machine
    • la quantité de mémoire vive (RAM exprimée en Go)
    • le modèle du CPU (ex : Dual Core i5-2450M@2.4GHz)
    • la version de liveUSB touchée par cette proposition
    • l’ébauche de la documentation envisagée (plan et léger contenu)
    • où placeriez-vous cette documentation ?
  7. Renseigner le champ Labels à étape: documentation
  8. Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement

NE PAS RENSEIGNER les champs Assignee et Milestone

7.3.2. Il faut améliorer la collection logicielle

  1. Assurez-vous d’avoir lu Structure de travail et répartition des rôles et la liste des logiciels installés dans Présentation du système liveUSB
  2. Connectez-vous à FramaGit (ouvrir un compte si besoin)
  3. Rendez-vous dans l’espace de gestion des incidents
  4. Accédez à la page de création d’une nouvelle issue
  5. Renseignez le champ Title d’une phrase très courte décrivant votre proposition : “ajouter le logiciel ‘0A.D.’” ou bien “supprimer le logiciel ‘ffmpeg’”
  6. Renseignez le champ Description d’une description détaillée décrivant votre proposition, avec les éléments minimum suivants :
    • le modèle de votre machine
    • la quantité de mémoire vive (RAM exprimée en Go)
    • le modèle du CPU (ex : Dual Core i5-2450M@2.4GHz)
    • la version de liveUSB touchée par cette proposition
    • le nom exact du paquet logiciel dans Debian distribution jessie
    • à quelle catégorie de logiciels celui-ci se rapporte-t-il ? (voir la liste des logiciels installés dans Présentation du système liveUSB)
  7. Renseigner le champ Labels à étape: configurer et ajouter le label :
    • pkg: manquant si vous prpoposez un ajout
    • pkg: à supprimer si vous prpoposez une suppression
  8. Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement

NE PAS RENSEIGNER les champs Assignee et Milestone

7.3.3. Il faut vraiment améliorer l’aspect esthétique du système liveUSB

  1. Assurez-vous d’avoir lu Structure de travail et répartition des rôles
  2. Connectez-vous à FramaGit (ouvrir un compte si besoin)
  3. Rendez-vous dans l’espace de gestion des incidents
  4. Accédez à la page de création d’une nouvelle issue
  5. Renseignez le champ Title d’une phrase très courte décrivant votre proposition : “changer l’image d’arrière plan du menu de démarrage”
  6. Renseignez le champ Description d’une description détaillée décrivant votre proposition, avec les éléments minimum suivants :
    • le modèle de votre machine
    • la quantité de mémoire vive (RAM exprimée en Go)
    • le modèle du CPU (ex : Dual Core i5-2450M@2.4GHz)
    • la version de liveUSB touchée par cette proposition
    • l’ébauche ou le contenu réel de la proposition (croquis, images, etc.)
    • où placeriez-vous cette ressource ? (optionnel)
  7. Renseigner le champ Labels à tuning
  8. Valider la création de cette nouvelle issue en appuyant sur le bouton Submit issue

Avertissement

NE PAS RENSEIGNER les champs Assignee et Milestone