Menu

Guide de documentation des tests de logiciels (pourquoi c'est important)

software testing documentation guide

Essayez Notre Instrument Pour Éliminer Les Problèmes

Au cours de ma carrière dans le domaine des tests logiciels, je n'ai jamais entendu les gens parler beaucoup de documentation sur les tests logiciels. L'opinion générale sur la documentation de test est que quiconque a du temps libre peut faire la documentation comme un cas de test, un plan de test, un rapport d'état, un rapport de bogue, une proposition de projet, etc.

Même moi, je n’ai pas insisté davantage sur la documentation, mais je peux dire que j’ai l’habitude de placer toutes les données en noir et blanc et d’en informer les autres également.

Guide de documentation des tests de logiciels (pourquoi

Ce que vous apprendrez:

Mon expérience

Je veux juste partager mon expérience avec vous:

Nous avions livré un projet (avec un problème inconnu) à l'un de nos clients (client en colère). Et ils ont trouvé le problème côté client, ce qui était une très mauvaise situation pour nous, et comme d'habitude, tout était blâmé sur le contrôle qualité.

Le problème concernait la compatibilité d'un site Web. En ce qui me concerne, j'avais la preuve que je n'avais pas reçu un tel document d'exigence qui stipule que je dois également vérifier la compatibilité du site Web. Dieu merci, j'étais en sécurité.

Ce fut la leçon pour moi, j'ai réalisé l'importance de la documentation et à partir de ce jour j'ai commencé à travailler sur des documents et à créer des documents de test comme le plan de test, les cas de test, la liste de contrôle des tests de cohérence, le rapport de bogue et bien d'autres.

'L'encre vaut mieux que le meilleur souvenir' - proverbe chinois

Documentation de test: qu'est-ce que c'est?

Nous lisons tous divers articles sur les technologies et méthodes de test, mais combien d'entre nous ont vu des articles sur la documentation? Nul doute qu'il y en a peu, est-ce que les documents ne sont pas importants? Non, mais c’est parce que nous n’avons pas encore réalisé l’importance des documents.

Mais, si nous observons alors le fait est, les projets qui ont tous les documents ont un haut niveau de maturité.

La plupart des entreprises n'accordent même pas un peu d'importance à la documentation autant qu'elles accordent au processus de développement logiciel. Si nous recherchons sur le Web, nous pouvons trouver différents modèles sur la façon de créer différents types de documents. Mais combien d'entre eux sont réellement utilisés par des organisations ou des individus?

Le fait est que une documentation minutieuse peut faire gagner du temps, des efforts et de l’argent à une organisation.

Tout en optant pour n'importe quel type de certification, pourquoi l'accent est mis sur la documentation, c'est simplement parce qu'elle montre l'importance du client et des processus pour l'individu et l'organisation. À moins que vous ne soyez en mesure de produire un document qui soit confortable pour l'utilisateur, quelle que soit la qualité de votre produit, personne ne l'acceptera.

C’est mon expérience, nous possédons un produit, qui a des fonctionnalités un peu déroutantes.

meilleurs programmes pour récupérer des fichiers supprimés

Quand j'ai commencé à travailler là-dessus, j'ai demandé des documents d'aide au Manager et j'ai obtenu la réponse «Non, nous n'avons pas de documents» Ensuite, j'ai posé un problème car en tant que QA que je connaissais, personne ne peut comprendre comment utiliser le produit sans documents ni formation. Et si l'utilisateur n'est pas satisfait, comment allons-nous gagner de l'argent avec ce produit?

«Le manque de documentation devient un problème d'acceptation» - Wietse Venema

Même la même chose s'applique aux manuels d'utilisation. Prenons un exemple de Microsoft, ils lancent chaque produit avec des documents appropriés, même pour Office 2007, nous avons de tels documents, qui sont très explicatifs et faciles à comprendre pour tout utilisateur. C’est l’une des raisons pour lesquelles tous leurs produits ont du succès.

Dans les petites entreprises, nous entendons toujours des «rejet de projet dans la phase de proposition ou de lancement», c'est simplement parce que la documentation de la proposition manque de langage concis et expressif, et pour montrer la capacité de l'organisation.

techniques de test boîte noire avec exemples ppt

Ce n’est pas que les petites entreprises ne peuvent pas livrer des projets de bonne qualité, mais c’est leur incapacité à exprimer leurs capacités. (Je travaille également avec une petite organisation de 80 employés, et j'ai entendu cela plusieurs fois)

Personnellement, je pense que la qualité est le seul département qui peut le rendre possible. Nous sommes le seul ministère à pouvoir argumenter à ce sujet et à assurer un avenir prospère à nos organisations.

Organisons toutes les discussions en quelques points dans une perspective de qualité:

- Clarifier l'objectif et les méthodes qualité
- Assurer la clarté des tâches et la cohérence des performances
- Assurer la coordination interne dans le travail client
- Fournir un retour d'expérience sur les actions préventives
- Fournissez des commentaires pour votre cycle de planification
- Créez des preuves objectives de la performance de votre système de management de la qualité

10 conseils pour vous aider à atteindre l'objectif de documentation de test

Comme je l'ai mentionné dans mon article précédent, en général, comprendre la documentation des tests de logiciels est «cela ne peut être fait que par la personne qui a du temps libre». Nous devons changer cette mentalité, et alors seulement nous pouvons tirer parti de la puissance de la documentation sur nos projets.

Ce n’est pas que nous ne savons pas comment bien faire la documentation. Nous ne pensons tout simplement pas que ce soit important.

Tout le monde doit disposer de modèles standard pour tous les types de documentation, depuis la stratégie de test, le plan de test, les cas de test et les données de test jusqu'au rapport de bogue.

Il s'agit simplement de suivre certaines normes (CMMI, ISO, etc.), mais en ce qui concerne la mise en œuvre réelle, combien de ces documents sont réellement utilisés par nous? Nous avons juste besoin de synchroniser notre processus qualité avec les normes de documentation et un autre processus dans une organisation.

La chose la plus simple pour suivre toutes sortes de documentation consiste à impliquer une personne dans le projet dès la phase de lancement qui comprend la dynamique, le domaine, l'objectif et la technologie du projet. Et qui d'autre mieux qu'une personne QA pour cela (bien sûr, il y a des rédacteurs techniques présents pour le faire - mais en considérant un scénario général de petites entreprises où les rédacteurs techniques ne sont pas présents).

Pour atteindre cet objectif de test et de documentation, je pense que nous devons nous concentrer sur certains points.

Voici les 10 meilleurs conseils pour vous aider à atteindre l'objectif de documentation du test:

#1) L'assurance qualité doit être impliquée dans la toute première phase du projet afin que l'assurance qualité et la documentation travaillent main dans la main.

#deux) Le processus défini par QA doit être suivi par des techniciens, cela permet d'éliminer la plupart des défauts à un stade très initial.

# 3) Créer et maintenir uniquement Modèles de test de logiciels ne suffit pas, obliger les gens à les utiliser.

# 4) Ne créez pas et ne quittez pas uniquement le document, mettez à jour au fur et à mesure des besoins.

# 5) Le besoin de changement est une phase importante du projet, n'oubliez pas de les ajouter à la liste.

# 6) Utilisez le contrôle de version pour tout. Cela vous aidera à gérer et à suivre facilement vos documents.

# 7) Facilitez le processus de correction des défauts en documentant tous les défauts. Assurez-vous d'inclure une description claire du défaut, de reproduire les étapes, la zone affectée et les détails sur l'auteur tout en documentant tout défaut.

# 8) Essayez de documenter ce qui est nécessaire pour que vous compreniez votre travail et ce que vous devrez produire à vos parties prenantes chaque fois que nécessaire.

# 9) Utilisez le modèle standard pour la documentation. Comme tout modèle de feuille Excel ou modèle de fichier doc et respectez-le pour tous vos besoins en matière de documents.

# dix) Partagez tous les documents liés au projet en un seul endroit, accessible à chaque membre de l'équipe pour référence ainsi que pour mettre à jour chaque fois que nécessaire.

Je ne dis pas qu'en appliquant des étapes, vous obtiendrez des résultats soudains. Je sais que ce changement ne se produira pas dans un jour ou deux, mais au moins nous pouvons commencer pour que ces changements commencent lentement.

Après tout, «la documentation a besoin de documentation». N'est-ce pas?

Des centaines de documents sont utilisés dans le cycle de vie du développement et des tests de logiciels.

Documents de test logiciels importants

Ici, je liste quelques documents de tests logiciels importants que nous devons utiliser / maintenir régulièrement:

type de test dans le développement de logiciels

1) Plan de test
2) Conception des tests et Spécification de cas de test
3) Stratégie de test
4) Rapports de synthèse des tests
5) Rapport d'état hebdomadaire
6) Documents / manuels utilisateur
7) Rapport d'acceptation de l'utilisateur
8) L'évaluation des risques
9) Journal de test
dix) Rapports de bogue
Onze) Données de test
12) Analyse des tests

De plus, les testeurs de logiciels ont régulièrement besoin de se référer aux documents suivants:
1) Spécifications des exigences logicielles
2) Documents fonctionnels

Conclusion

Les documents de test de logiciel jouent toujours un rôle important dans la phase de développement / test du projet. Alors gardez toujours les choses documentées autant que possible. Ne vous fiez pas à la communication verbale. Soyez toujours du bon côté.

La documentation vous permettra non seulement d'économiser, mais aidera également l'organisation à long terme à économiser des milliers de dollars sur la formation et, plus important encore, sur la résolution des problèmes causés par le manque de documents de développement et de test.

Ne documentez pas simplement pour éviter de vous pointer du doigt, mais l'habitude de la documentation apportera certainement une approche systématique à votre processus de test, laissant les tests ad hoc derrière.

À propos de l'auteur: Cet article est écrit par un membre de l'équipe STH Tejaswini. Elle travaille en tant que responsable QA dans une organisation.

Quels autres documents conservez-vous dans vos activités de test quotidiennes?

lecture recommandée

^