Стандарт кодирования вики - PullRequest
Новая
       7

Стандарт кодирования вики

8 голосов
/ 23 января 2009

На моем рабочем месте мне поручено создать документ по стандартам кодирования. Обычно мы следуем тому, что сообщают инструменты FxCop и StyleCop, но нам действительно нужен документ, который объяснит, когда использовать соглашение, почему и, возможно, даже простой пример.

Это может быть расширено в будущем и для других целей.

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

Если возможно, двигатель должен быть на C #, поэтому мы можем настроить его под наши нужды, если потребуется.

Если вы считаете, что вики-решение - неправильный путь, пожалуйста, дайте альтернативу:)

Обновление

Мне только что сообщили, хотя у нас есть php-сервер, на котором он не останется, поэтому я боюсь, что идеи вики на основе php не обсуждаются.

Обновление 2

Не могли бы вы также (если возможно) сообщить мне, работает ли какое-либо из этих решений с Active Directory?

Приветствие Tony

Ответы [ 9 ]

4 голосов
/ 23 января 2009

ScrewTurn Wiki - это бесплатная вики с открытым исходным кодом, созданная на C # и ASP.Net. Могут быть использованы разные базы данных, такие как MSSQL и MySQL, но они также работают без какой-либо базы данных. Он имеет несколько плагинов для работы с Active Directory.

2 голосов
/ 12 февраля 2009

Mindtouch Deki

Отличная вики, она построена на C # и PHP, поэтому вы можете использовать ее в Mono или .NET Он также имеет интеграцию с Active Directory.

Загрузите готовый образ VMware. Он начал использовать его на моем собственном ПК, а затем перенес его на сервер VMware компании, когда они были готовы.

1 голос
/ 23 января 2009

Брэд Абрамс опубликовал онлайновый набор стандартов кодирования на C #:

http://blogs.msdn.com/brada/articles/361363.aspx

Если вы перейдете в раздел стартовых наборов на сайте Microsoft ASP.NET, вы найдете несколько вики для загрузки, такие как ScrewTurn и Flexwiki. Звучание вики идеально подойдет для ваших нужд: -)

1 голос
/ 23 января 2009

Мы используем JAMWiki и любим его.

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

Парень, у которого вы поддерживаете код, отлично работает, отвечая на вопросы и помогая пользователям.

1 голос
/ 23 января 2009

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

0 голосов
/ 23 января 2009

Меня смущает, что вы имеете в виду, когда говорите, что у вас нет php-сервера. Он работает на каждой платформе, известной человеку. Я заметил, что большинство разработчиков Visual Studio не знают, что PHP работает на IIS.

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

0 голосов
/ 23 января 2009

В магазине я использую коммерческий пакет, который действительно хорош: Слияние . Что особенно приятно, так это то, что он интегрируется с LDAP / AD, так что вам не требуется отдельный вход в систему, и он создан специально для бизнеса и имеет множество бесплатных плагинов. Мы не могли бы жить без этого.

0 голосов
/ 23 января 2009

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

Я даже генерирую часть документации по разработке прямо из исходного кода и базы данных.

0 голосов
/ 23 января 2009

Я второй MediaWiki. Это не C #, но это может быть хорошим предлогом, чтобы проникнуть через бесплатное ПО через черный ход.

Если вы, ребята, из магазина Microsoft, хотя и используете Sharepoint, у него есть встроенная функциональность в вики-стиле.

...