2009-11-22 3 views
4

Вот и проблема, мне нужно найти/подумать о стандартах документации для нашей команды. У нас есть несколько потребностей, мы нужны стандарты документации для Требования к документации, Техническая документация - проектов и Code Style Документация - для разработчиков, которые охватывали бы как разработчики должны назвать, и организовать код проекта (должен ли он использовать регионы? Как следует искать имена и т. д.), я знаю, что он может варьироваться от проекта к проекту, но, возможно, для этого существуют какие-то стандарты. В настоящее время каждый разработчик пишет это, как он воображает, и это не так хорошо, потому что оно противоречиво и с разными стилями и т. Д.Передовая практика: стандарты документации

Мне любопытно, как вы/ваша компания это делаете. И, может быть, для этого существуют какие-то стандарты.

Как это должно выглядеть? Какой контент он должен включать? и т. д.

BTW мы используем .NET Technologies.

ответ

9

Брэд Абрамс опубликовал пример внутреннего кодирования основного положения Microsoft на своем блоге несколько лет назад: http://blogs.msdn.com/brada/articles/361363.aspx

Смотрите также Руководство Microsoft Design по разработке библиотек классов http://msdn.microsoft.com/en-us/library/ms229042.aspx

+0

Мне понравилось внутреннее руководство по кодированию Microsoft. Есть ли полная версия? Или аналогичный документ по тем же правилам? –

+0

Я думаю, что это полная версия - я бы не ожидал, что руководство по кодированию будет содержать гораздо больше - наша работа на аналогичной длине. –

+0

Выглядит очень хорошо. Но как насчет документации по техническим требованиям и требованиям? любые стандарты для них? –

2

У меня была такая же проблема, и я обратился к IEEE, чтобы найти некоторые стандарты. Я нашел следующее, что я еще не читал, но кажется, отношение:

Общие стандарты документации

Кроме них, есть также являются отличным обзором на уровне www.codingthearchitecture.com

Стандарты кодирования стиль

Помимо очень тонких «Руководства Microsoft Design для развивающихся библиотек классов», упомянутых выше, есть некоторые очень хорошие аргументы, которые будут найдены в Linux Kernel Coding Style Guidelines, даже несмотря на приведенные примеры есть в С.

Смежные вопросы