Coding Standard Wiki

8

An meinem Arbeitsplatz wurde mir die Aufgabe übertragen, ein Kodierungsstandarddokument zu erstellen. Im Allgemeinen befolgen wir, was FxCop und StyleCop-Tools zu einem gewissen Grad berichten, aber was wir wirklich benötigen, ist ein Dokument, das erklärt, wann eine Konvention verwendet wird, warum und vielleicht sogar ein einfaches Beispiel.

Dies könnte in der Zukunft auch für andere Zwecke erweitert werden.

Das erste, was mir in den Sinn kam, war eine interne Wiki-Site, die wir im Laufe der Zeit aufbauen und ändern konnten, aber ich habe noch nie zuvor eine wiki-basierte Engine verwendet und hätte gerne einige Empfehlungen.

Wenn möglich, sollte der Motor in C # sein, damit wir ihn bei Bedarf anpassen können.

Wenn Sie der Meinung sind, dass eine Wiki-Lösung der falsche Weg ist, dann geben Sie bitte eine Alternative an:)

Aktualisieren

Ich wurde gerade informiert, obwohl wir einen PHP-Server haben, den es nicht behalten wird, also fürchte ich, dass php-basierte Wiki-Ideen vom Tisch sind.

Update 2

Könnten Sie mir (wenn möglich) auch mitteilen, ob eine dieser Lösungen mit Active Directory funktioniert?

Prost Tony

    
TWith2Sugars 23.01.2009, 13:32
quelle

9 Antworten

4

ScrewTurn Wiki ist ein freies und Open-Source-Wiki, das in C # und ASP.Net erstellt wurde. Verschiedene Datenbank-Back-Ends können verwendet werden, wie MSSQL und MySQL, aber auch ohne jegliche Datenbank. Es hat mehrere Plugins , um mit Active Directory zu arbeiten.

    
Lars Truijens 23.01.2009, 14:19
quelle
2

Mindtouch Deki

Tolles Wiki und es basiert auf C # und PHP, also können Sie es auf Mono oder .NET verwenden Es hat auch Active Directory Integration.

Laden Sie das fertige VMware-Image herunter. Es begann damit, es auf meinem eigenen PC zu verwenden und dann auf den VMware-Server des Unternehmens zu verschieben, sobald es fertig war.

    
lamcro 12.02.2009 15:26
quelle
1

Wir haben ein internes Wiki in meinem Shop, das fast unsere gesamte Dokumentation enthält (nicht nur Codierungsstandards). Wir haben nicht wirklich die Notwendigkeit gesehen, unser eigenes zu rollen, also haben wir MediaWiki ...

verwendet     
Jason Punyon 23.01.2009 13:35
quelle
1

Wir benutzen JAMWiki und lieben es.

Es ist eine solide Anwendung, wir hatten nur eine gute Interaktion mit der Anwendung und den Entwicklern.

Der Typ, für den Sie den Code verwalten, ist sehr gut dabei, Fragen zu beantworten und Benutzern zu helfen.

    
Berek Bryan 23.01.2009 13:54
quelle
1

Brad Abrams hat einen Online-Satz von C # -Kodierungsstandards veröffentlicht:

Ссылка

Wenn Sie auf der Microsoft ASP.NET-Site zum Abschnitt "Starterkits" wechseln, finden Sie mehrere Wikis zum Herunterladen, z. B. ScrewTurn und Flexwiki. Ein Wiki wäre ideal für Ihre Bedürfnisse durch den Klang davon: -)

    
IrishChieftain 23.01.2009 15:10
quelle
0

Ich zweite MediaWiki. Es ist nicht C #, aber es kann eine nette Ausrede sein, um ein paar freie Software durch die Hintertür hereinzuschleichen.

Wenn Sie jedoch ein Microsoft-Shop sind und Sharepoint verwenden, verfügt er über einige integrierte wiki-ähnliche Funktionen.

    
Dana 23.01.2009 13:45
quelle
0

In einem Projekt, das ich entwickle, richte ich ein MediaWiki-Wiki für die Entwicklungsdokumentation ein, und eines für die Online-Hilfe.

Ich selbst generieren Teil der Entwicklungsdokumentation direkt aus Quellcode und Datenbank.

    
devio 23.01.2009 13:47
quelle
0

Im Laden, in dem ich bin, benutzen sie ein kommerzielles Paket, das wirklich gut ist: Confluence . Besonders schön ist, dass es in LDAP / AD integriert ist, so dass Sie kein separates Login benötigen und es speziell für geschäftliche Zwecke entwickelt wurde und über viele kostenlose Plugins verfügt. Ohne sie könnten wir nicht leben.

    
TravisO 23.01.2009 13:50
quelle
0

Ich bin verwirrt, was du meinst, wenn du sagst, dass du keinen PHP-Server hast. Es läuft auf jeder dem Menschen bekannten Plattform. Ich bemerke, dass die meisten Visual Studio-Entwickler nicht wissen, dass PHP auf IIS läuft.

Ich würde mit mediawiki gehen. Es hat den größten Funktionsumfang und die meisten Add-Ons, die dafür entwickelt wurden, falls Sie Ihre Daten irgendwo anders portieren müssen. Wenn Sie Ihr Wiki ändern müssen, machen Sie es falsch.

    
Shawn 23.01.2009 15:12
quelle

Tags und Links