Здравствуйте, господа. У меня такой вот вопрос. Что обычно используют в недрах MS для документирования программного проекта. Какие технологии. Меня пытаются убедить, что MS пишет код на коленках, т.е. перед написанием непосредственно кода не пишет абсолютно никакой документации. Пытается убедить меня сотрудник одного из региональных подразделений MS. У меня большая просьба, кто знает, откликнитесь. Я знаю, что это не так, но мне необходимы доводы, чтобы убедить человека в обратном. Т.е. если кто знает какие технологии и термины применяются в недрах MS для описание технической документации программного проекта.
Заранее спасибо!

Модератор: Тема перенесена из форума "Разработка информационных систем".

В том то и дело, что знает, но пытается убедить меня в том, что они не пишут документацию при разработке проекта. Я так понял все дело в том, что за эту документацию они хотят или не хилые деньги, или же просто не хотят пускать нас в разработку в дальнейшем, хотя по контракту они обязаны передать нам все исходники системы. Но без документации это же просто темных лес, и он это отлично понимает и ссылается на то, что они документацию просто напросто не пишут. Т.е. они этакие студентики, которые пишут код на коленке. Поэтому мне нужны аргументы, чтобы вывести людей на чистую воду.

В связи с этим есть вопрос - данная технология документирования проекта она обязательна в недрах MS?

Почитав об MSF у меня возник следующий вопрос. Обязательно ли для MS готовить проектную документацию для потребителей, если по контракту передаются исходные коды всей системы?

Mr MarmeladА6дуллаhНеправильная постановка вопроса.
Неважно, что там использует MS у себя..

А Особенно людей из Microsoft. У них просто по другому не может быть. Куча шаблонов и все часики расписаны по нотам. Документация - если следовать ISO стандартам - а Мелкомягкие ему следуют - не помню чтобы не следовали - часть процесса {если не сам процесс как в MSF} .... Так что в договор даже и вписывать нечего - можно просто спросить - а где документация?



Вот такой логике я и следовал. Я внимательно перечитал контракт, и в нем действительно нет того, что нам будет предоставлена проектная документация. Сейчас люди из MS не говорят, что за нее надо заплатить отдельно, а говорят именно что, т.к. на нее изначально не было денег, то и документации нет и не будет.
И еще очень важный момент, в контракте прописано, что разработка решения будет соответствовать MSF.
Насколько я понял из Вашего поста, как раз это и гарантирует наличие проектной документации?

P.S. Спасибо, Вам Mr Marmelad, за желание помочь, просто на данный момент времения я еще не получил санкцию от президента компании на раскрытие данной ситуации, но в любом случае я опишу Вам, что из всего этого получилось.

Mr MarmeladHomosumИ еще очень важный момент, в контракте прописано, что разработка решения будет соответствовать MSF.
Насколько я понял из Вашего поста, как раз это и гарантирует наличие проектной документации?


Коллега - Ну вот Вы задали вопрос который требует от меня однозначного ответа. Давайте я попробую объяснить. Когда писатель пишет свой рассказ, скажем - он использует свои знания, перо, бумагу или компьютер. Это из области обще-принятых условий. Сдать продукцию - значит - предоставить написанный документированный рассказ. На самом деле он не должен отчитываться как именно он писал - ручкой ли, машинкой пишущей или компьютером. А может и не писал ничего а диктовал и жена печатала... Следите за мыслью? Почитайте внимательно вот этот топик В Американской и в любой другой практике сдачи продукта - обязательно сдача документации. Документация часть продукта и обычно генерируется и контролируется в процессе разработки. Без документации нет продукта. Давайте спросим так - каковы критерии приёма сдачи у вас по контракту?

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

System documentation
System documentation will consist of 1) System Conceptual Design; 2) System installation and configuration manual; 3) System administration manual; 4) System user manual; 5) System support and maintenance manual.
Acceptance criteria:
• Design documents complies with requirements and standards ( relevant to qualified CA );
• System documentation consist all necessary details and passes customer’s quality review.

Но как Вы видите, данная там не ни слова о документации по программному коду и продукту в целом. На мой вопрос о том есть ли такая документация у них, они сначала ответили, что нет, но после моей ссылки на MSF, они сразу исправились, что такая документация есть, но они ее не дадут, т.к. она не указана в контракте.
Меня это очень не устраивает, т.к. по сути они нам предоставляют черный ящик, вокруг которого нам придется разве что плясать с бубном. Хотя в самом начале проекта они раз за разом нам говорили, что у Вас будут и исходные коды и документация к ним. А сейчас прямо заявляют, что документации не будет. Но!
Есть следующий пункт контракта, который гласит.

Full NCSC IS and binaries
Full NSCS IS solution had been deployed in production; binaries had been supplied on installation Acceptance criteria:
• NCSC IS solution is installed in production environment and passed all test scenarios with no critical errors, not more than to 2 major errors and no more than 10 minor errors;
• Solution binaries ( source code, installation packages ) had been delivered to customer on DVD media.

По данному пункту они нам предоставляют исходные коды. Вот тут у меня возникает вопрос (на основе Вашего поста - В Американской и в любой другой практике сдачи продукта - обязательно сдача документации), если есть исходные коды, то значит и должна быть документация к ним?
Если я рассуждаю правильно, то у меня такой вопрос, где можно найти источники данной практики (книги, рекомендации самого MS и т.д.), чтобы я более аргументированно мог говорить с партнерами.