Estoy trabajando en la creación de una oferta SaaS. ¿Cuál es la mejor manera de escribir documentación que se alojará en el sitio web?

Wiki es definitivamente el camino a seguir. La única preocupación es cuánto tiempo vale la personalización.

Después de haber trabajado con media docena de motores wiki diferentes, he llegado a lo siguiente:

Wiki de SharePoint: super fácil => super feo
MediaWiki: extremadamente personalizable => curva de aprendizaje extremadamente alta

Todos los demás parecen caer en algún lugar en el medio. Si va a hacer toda la documentación usted mismo, tal vez la dificultad no sea importante. Por otro lado, es probable que desee pasar su vida codificando el producto, sin descifrar la sintaxis de una wiki.

Y luego está el costo. MediaWiki es gratuito, al igual que muchos CMS (sistemas de gestión de contenido) como WordPress. De hecho, Django tiene su propio CMS gratuito: Django-cms.

Me decidí por Confluence para mi empleador actual, por su facilidad de uso (se esperaba que los ingenieros escribieran por su cuenta), miradas (la información tenía que ser presentable), personalización (un poco más difícil que solo escribir, pero más fácil que MediaWiki), y copia impresa presentable imprimible (para los viejos escolares).

Eche un vistazo a readme.io si hacer una aplicación basada en suscripción es una opción.