MichioKim

 

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

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

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

Вероятнее всего, у вас "автоматизация ради автоматизации".

Если это верно, то все равно что вы делаете. На работу ходите. И все.

Я такой проект видел. 20 человеколет. Результат - ноль. Просто ноль. Вообще ноль. Посто потратили на "автоматизацию" кучу бабла. Результат не получили. Зато была "автоматизация".

 

Нет, тут не правы. Автоматизация у нас очень много убирает ручного труда.

Очень много разных вещей приходиться проверять и перепроверять по несколько раз.

Постоянно находим какие-то дефекты/проблемы.

У нас очень частых выход билдов и каждый раз проверять это все в ручную это просто убиться. 

У меня несколько проектов на базе ТестКомплита. Документация ведется либо в обычном док-файле, либо в вики. 

Но вам действительно придется познавать все методом тыка, сочувствую. Но в помощь вам прекрасно разработанная документация по самому инструменту.

На самом деле тоже начал уже писать документацию в doc файл, точнее гугл/doc видимо это самый просто и легко реализуемый вариант

Ок, для начала, вы с какой целью хотите эту документацию разработать? Чтобы что? Сформулируйте ваши цели

Основная цель для меня - понять как работает вся эта совокупность тестов.

Узнавать придется методом тыка по названиям функций, описанию теста в тестлоге.

Побочная цель - оставить после себя файл в котором структурировано храниться информация об основных функциях которые используются в проектах. А так же заметки о возможных проблемах которые могут возникнуть во время разработки.