Организация документация в автоматическом тестировании. Как организовать?

Question

[Michio -]

Есть имеющийся проект в Test Complite (точнее 2 проекта) с полным отсутствие документации.

По скольку автоматизаторов было всего 2 человека и были они все с начала истоков введения автотестов, то документация им эта была до лампочки т.к. сами они это все писали и знали что и как устроено. + есть несколько документов с инструкциями и описаниями различных процессов внутри проекта
Сейчас я пришел в этот проект и знакомясь с проектом все познаю методом тыка. Хочется структурировать это все в один файл документа.
Какими средствами это лучше сделать?

Что есть сейчас:
Несколько отдельных проектов в Test Complite в которых содержится код тестов
Около 10 файлов объясняющих отдельные фичи, например настройки XML файлов
Все тесты хранятся в общем с мануальщиками в проекте TestLpg

Comments

[Эдуард Тибет]

Вы не подкажете, каким образом и в каком формате описываются тесты TestComplete?

Answer 1

[azShoo]

Я бы на вашем месте в первую очередь ответил себе на вопрос "Какую проблему должна решить нужная вам документация".
Для чего вы хотите её написать?
Что бы структура проекта автотестов, его запуска и пр. были более прозрачными для нового человека?
Что бы было очевидно, какие кейсы покрыты автотестами, а какие нет?
Что бы было понятно, какие именно действия и проверки выполняются в том или ином автотесте?
Что бы просто была документация и всем было хорошо?

Как только появится список конкретных проблем, которые желаемая вами документация должна решить - выбор того, как должен выглядеть нужный вам документ будет более очевиден.