Архив рубрики 'Примеры проектных документов'

Регламент работы с репозиторием кода

Четверг, Август 3rd, 2017

Этот регламент писался давно. Сейчас многое изменилось. Например, SVN теперь не в моде. Да и техники на вашем проекте могут быть другими. Вместо термина “trunk” вы может быть будете использовать “master”. А жет еще что-то. Так что адаптируйте документ под себя. А то, что есть – используйте как рыбу.Документ специально написан коротко, т.к. длинные документы никто не читает.
И обратите внимание, многие отдельные пункты регламента сопровождаются описанием контрольных процедур, с указанием ответственного. Без контрольных процедур регламенты работают плохо. Сейчас я бы эти описания серьезно расширил.

Да, еще. Нам этот документ довольно сильно облегчил нам жизнь.
(more…)

Соглашения о наименовании объектов БД

Понедельник, Июль 10th, 2017

Предисловие

Просматривал старые файлы - обнаружил множество проектных документов. Вещь редкая, почти не встречающаяся.

Публикую первый. Вдруг кому поможет? Я не говорю, что документ надо использовать “как есть”. Но может он подскажет, как писать.Вы напишите свой документ.
Нам этот документ помог улучшить такой критерий качества, как “Модифицируемость” группы”Сопровождаемость” по ГОСТ 25010.
Что касается НДА… И продукта того нет, и фирмы, и дюжина лет прошла… А документы такого типа по прежнему актуальны.

Чуть не забыл. Чем короче стандарт, тем он эффективнее на единицу текста. Начинайте с коротких стандартов. 500-1000, пусть 2000 слов. В этом документе было 771 слово. И он был эффективен.
(more…)