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
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 ...
verwendetWir 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.
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.
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.
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: -)
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.
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.
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.
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.