Codificación estándar de Wiki

En mi lugar de trabajo, me encargaron de crear un documento de estándares de encoding. En general, seguimos lo que las herramientas de FxCop y StyleCop reportan hasta cierto punto, pero lo que realmente necesitamos es un documento que explique cuándo usar una convención, por qué y quizás incluso un ejemplo simple.

Esto podría extenderse en el futuro para otros propósitos también.

Lo primero que me vino a la mente es tener un sitio wiki interno que pudiéramos construir y cambiar fácilmente con el tiempo, pero nunca antes he usado un motor basado en wiki y me gustaría recibir algunas recomendaciones.

Si es posible, el motor debe estar en C #, de modo que podamos adaptarlo a nuestras necesidades si es necesario.

Si cree que una solución wiki es la forma incorrecta de hacerlo, por favor, dé una alternativa 🙂


Actualizar

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


Actualización 2

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

Saludos Tony

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

Mindtouch Deki

Excelente wiki y está construido en C # y PHP, así que puedes usarlo en Mono o .NET. También tiene integración con Active Directory.

Descargue su imagen de 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.

Mantenemos una wiki interna en mi tienda que tiene casi toda nuestra documentación (no solo los estándares de encoding). Realmente no vimos la necesidad de rodar la nuestra, así que solo usamos MediaWiki …

Usamos JAMWiki y nos encanta.

Es una aplicación sólida, solo hemos tenido una buena interacción tanto con la aplicación como con los desarrolladores.

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

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

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

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

Yo segundo MediaWiki. No es C #, pero puede ser una buena excusa para colar algún software libre a través de la puerta trasera.

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

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 genero parte de la documentación de desarrollo desde el código fuente y la base de datos.

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 por separado y se cree especialmente para el uso empresarial y tiene muchos complementos gratuitos. No podríamos vivir sin él.

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. Me doy cuenta de que la mayoría de los desarrolladores de Visual Studio no saben que PHP se ejecuta en IIS.

Me gustaría ir 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 trasladar tus datos a otro lugar. Si necesitas modificar tu wiki lo estás haciendo mal.