Wiki estándar de codificación

Question

En mi lugar de trabajo me han encargado de crear un documento de estándares de codificación. En general, seguimos en cierta medida lo que las herramientas FxCop y StyleCop informan, pero lo que realmente necesitamos es un documento que explique cuándo utilizar una convención, por qué y tal vez incluso un simple ejemplo.

Esto podría extenderse en el futuro para otros fines también.

Lo primero que se me ocurrió es tener un sitio wiki interno que pudiéramos construir y cambiar fácilmente con el tiempo, pero nunca antes había usado un motor basado en wiki y quisiera algunas recomendaciones.

Si es posible, el motor debería estar en C # para que podamos ajustarlo a nuestras necesidades si es necesario.

Si crees que una solución wiki es la forma incorrecta de hacerlo, entonces da una alternativa :)

---

Update

Me acaban de informar, aunque tenemos un servidor php en el que no se quedará, así que me temo que las ideas wiki basadas en php no están disponibles.

---

Actualización 2

¿Podría también (si es posible) avisarme si alguna de estas soluciones funciona con Active Directory?

Saludos Tony

Answer 1

ScrewTurn Wiki es un wiki gratuito y de código abierto hecho en C # y ASP.Net. Se pueden usar diferentes bases de datos, como MSSQL y MySQL, pero también funciona sin ninguna base de datos. Tiene varios complementos para trabajar con Active Directory.

Answer 2

Mindtouch Deki

Gran wiki y está construido en C # y PHP, por lo que puede usarlo en Mono o .NET También tiene integración de Active Directory.

Descargue su imagen VMware lista para usar. Comenzó a usarlo en mi propia PC y luego lo movió al servidor VMware de la compañía cuando lo tenían listo.

Answer 3

Mantenemos un wiki interno en mi tienda que tiene casi toda nuestra documentación (no solo los estándares de codificación). Realmente no vimos la necesidad de rodar el nuestro, así que solo usamos MediaWiki ...

Answer 4

Usamos JAMWiki y nos encanta.

Es una aplicación sólida, no hemos tenido más que una buena interacción tanto con la aplicación como con los desarrolladores.

El tipo con el que mantiene el código hace un gran trabajo respondiendo preguntas y ayudando a los usuarios.

Answer 5

Brad Abrams ha publicado un conjunto en línea de estándares de codificación C #:

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

Si va a la sección de kits de inicio del sitio Microsoft ASP.NET, encontrará varios wikis para descargar, como ScrewTurn y Flexwiki. Un wiki sería ideal para sus necesidades por el sonido que tiene :-)

Answer 6

Yo segundo MediaWiki. No es C #, pero puede ser una buena excusa para introducir algo de software libre por la puerta trasera.

Sin embargo, si ustedes son una tienda de Microsoft y están utilizando Sharepoint, tiene alguna funcionalidad wiki-esque incorporada.

Answer 7

En un proyecto que desarrollo, configuré un wiki de MediaWiki para la documentación de desarrollo y otro para la ayuda en línea.

Incluso generar parte de la documentación de desarrollo directamente desde el código fuente y la base de datos.

Answer 8

En la tienda en la que estoy, usan un paquete comercial que es realmente bueno: Confluence . Lo que es especialmente bueno es que se integra con LDAP / AD para que no necesite un inicio de sesión separado y está especialmente diseñado para el uso comercial y tiene muchos complementos gratuitos. No podríamos vivir sin él.

Answer 9

Estoy confundido por lo que quieres decir cuando dices que no tienes un servidor php. Se ejecuta en todas las plataformas conocidas por el hombre. Noto que la mayoría de los desarrolladores de Visual Studio no saben que PHP se ejecuta en IIS.

Yo elegiría con mediawiki. Tiene el conjunto de características más grande y la mayoría de los complementos desarrollados para él en caso de que alguna vez necesites transferir tus datos a otra parte. Si necesita modificar su wiki, lo está haciendo mal.