Alojamiento de manuales de usuario

Estoy buscando un servicio en línea para redactar y alojar manuales de usuario de software, con las siguientes características:

  • Basado en la nube (host público), confiable para alojamiento a largo plazo
  • Admite múltiples documentos con múltiples secciones
  • Sintaxis de Markdown (preferiblemente versión de GitHub)
  • Fácil carga de mapas de bits
  • Tabla de contenido
  • Permitir comentarios del lector
  • Exportar a PDF (deseable)
  • Puede ser gratis o de bajo costo

Estaba pensando en un CMS basado en rebajas, pero todavía no puedo encontrar el adecuado.

Jamie, Este sitio es para recomendar software en lugar de sitios web o servicios en línea.
@SteveBarnes: Suena sobre el tema para mí, solicitando características específicas como comentarios y tabla de contenido. No es solo alojamiento HTML.
¿Gratis? ¿Cual es tu presupuesto? ¿Quieres conservar los derechos de autor? ¿Debería el contenido ser exportable para evitar el bloqueo? ¿Todo es público o quieres mantener algunas partes restringidas a un grupo específico de personas? ¿Necesita hipervínculos?
Esto suena como alojamiento propio y, por lo tanto, sobre el tema. ¿Lo hice bien esta vez?
ACLARACIÓN : No quiero hospedarme por mi cuenta. Es por eso que menciono un alojamiento confiable a largo plazo. Estoy buscando algún tipo de SaaS. Acabo de encontrar manula.com , pero no me gusta su lenguaje de rebajas no estándar.
@NicolasRaoul, $0-$30 mensuales estaría bien. Los manuales pertenecen a productos y servicios de software protegidos por derechos de autor, pero son públicos. Los hipervínculos no son necesarios hasta el momento.

Respuestas (3)

¿Ha considerado Leer los documentos ?

  • Puede importar sus documentos utilizando cualquier sistema de control de versiones principal, incluidos Mercurial, Git, Subversion y Bazaar.
  • Admiten webhooks para que tus documentos se construyan cuando confirmas el código.
  • También hay soporte para el control de versiones para que pueda crear documentos a partir de etiquetas y ramas de su código en su repositorio.
  • La documentación de alojamiento es gratuita y sencilla.
  • Creación de documentos en Markdown o ReStructuredText
  • Mapas de bits, svg, etc., simplemente comprométase con su sistema de control de versiones.
  • Soporte técnico de Python Sphinx
  • Soporta múltiples versiones de documentos.
  • Admite descargas como HTMLZip, PDF o Epub.
  • Puede alojar el código fuente de sus libros en github, bithub, etc.
  • Read the Docs es en sí mismo de código abierto, por lo que puede tener una prueba o una instancia interna ejecutándose detrás de un firewall.
  • Buscable
  • No admite comentarios directamente, pero puede incluir enlaces a un sistema de tickets en github, por ejemplo, o usar Disqus .
  • Organizado por Rackspace
  • Muchos proyectos tienen su documentación alojada en Read The Docs, por lo que espero algo de longevidad.
Aunque me parece atractivo (un desarrollador), su proximidad a github parece bastante técnica para un editor de documentos y lectores. La falta de soporte para comentarios es un obstáculo, ya que no estoy dispuesto a hacer la integración yo mismo, sino que estoy buscando una solución completa de terceros (SaaS).
@Jaime: realice un curso de capacitación para sus desarrolladores sobre control de versiones; sugeriría Mercurial, (hg), ya que es realmente fácil de usar en comparación con git , una vez que descubran que pueden revertir versiones, etc., los autores de sus documentos y a los editores les encantará el control de versiones, a los editores también les gustará la herramienta de culpa.
Steve, mis desarrolladores conocen muy bien las versiones de código fuente. ¿Quién hoy en día no? Pero los desarrolladores no escriben manuales de usuario.
@Jaime - Lo siento, tenía la intención de escribir un curso para sus autores y personal editorial. Por cierto, se sorprendería de la cantidad de desarrolladores que conozco que piensan que el control de versiones es simplemente copiar allí el trabajo en otro lugar, a menudo en la misma máquina , de vez en cuando. Incluso hubo uno que se quejó de que lo estaba deteniendo. archivos en SVN, así como archivos .obj y .pdb.

Lo que he encontrado realmente funciona bien es Github . Después de todo, es:

  • Admite Markdown nativo de Github
  • Renderiza Markdown cuando navegas hacia él
  • Mantiene versiones
  • Ofrece alojamiento gratuito
  • Permite comentarios

Muchas de las características que le interesan.

caorogjin, puedo sentir la tentación de enseñar Markdown a los editores manuales, pero github es definitivamente un buen entorno para los usuarios finales.

Asegúrate de revisar http://tome.host/

Es una plataforma SaaS para escribir y alojar documentos/manuales, actualmente se encuentra en fase beta.

es compatible

  • múltiples documentos
  • varios usuarios en el mismo documento
  • tener una versión publicada mientras trabajas en un borrador
  • soporte de imagen
  • exportar en diferentes formatos y algunas otras cosas
Alojamiento de manuales de usuario
RespuestasAquíPolítica de privacidad1y, 0v