Esta página contiene los detalles de un proyecto de redacción técnica aceptado para la temporada de Documentos de Google.
Resumen del proyecto
- Organización de código abierto:
- SO Qubes
- Escritor técnico:
- luz web
- Nombre del proyecto:
- Integración con QubesOS Escribamos una guía abierta y fácil de usar
- Duración del proyecto:
- Duración estándar (3 meses)
Project description
Integra a QubesOS.
Me gustaría crear una guía abierta y materiales relacionados para los usuarios que usan QubesOS por primera vez. El objetivo sería presentar QubesOS al experto y hacer que la guía sea lo más comprensible y comprensible posible mediante analogías, ilustraciones y diagramas. Para mantener la coherencia, se usarán vínculos a recursos confiables, incluidos, en primer lugar, los que se encuentran en el sitio web de QubesOS. Todo se lanzará bajo una licencia abierta.
Por "independiente", me refiero a contenido que puede existir independientemente del sitio web, por ejemplo, como un manual. No es equivalente a la versión sin conexión de la guía. Idealmente, se creará otra canalización para publicar el contenido como guía, junto con el sitio web.
Cuando decimos "abierta", nos referimos a una guía que se lanzará bajo una licencia abierta.
Cómo se podría hacer
Definir el público objetivo
Actualmente, tengo la impresión de que la categoría de usuarios a la que se orienta QubesOS no está bien definida. ¿Cómo puede QubesOS ayudar a periodistas, abogados, analistas de seguridad, desarrolladores de software, etcétera? Sería útil describir situaciones en las que QubeOS puede resultar útil.
Establece las expectativas correctas
También sería importante advertir a los usuarios nuevos que QubesOS requiere un buen nivel de conocimientos de TI. El uso de QubesOS tiene que pagar, en términos de usabilidad, especialmente si QubesOS es tu sistema de procesamiento principal. Del mismo modo, hay cosas que QubeOS no hará bien (por diseño), como la aceleración 3D en máquinas virtuales. Es importante dejarlo claro desde el principio, no disuadir a las personas de usarlo, sino establecer excepciones para los posibles usuarios.
Qué es QubesOS y qué no
Si bien QubesOS es una clase especial de sistema operativo (una distribución Xen), sería interesante compararlo con otros sistemas operativos según sus funciones o su falta (por ejemplo, Windows utiliza cada vez más la virtualización y las zonas de pruebas como mecanismos de seguridad). Podría usarse un diagrama o una tabla simple.
La comunidad definirá las especificaciones de la guía.
¿Cuál es la información mínima que debe contener la guía? ¿En qué medida se puede simplificar la instalación sin sacrificar la seguridad? ¿Dónde debería estar el umbral? ¿Existe una configuración de QubesOS mínimamente viable y segura? Si la respuesta es no, puede definirse y establecerse como el objetivo de la guía.
Licencia
Obtener una licencia La respetada wiki de Archlinux usa la Licencia de documentación libre de GNU 1.3 o una versión posterior. ¿Esta licencia sería una buena opción?
Otros finales
Hacer que la documentación del sitio web sea más atractiva visualmente
Las notas se pueden resaltar con colores rojo o amarillo para que sea más fácil distinguirlas. Por ejemplo, se podrían usar cuadros de color, como los que se encuentran en la wiki de archlinux. https://wiki.archlinux.org/index.php/Linux_Containers.
Se pueden usar bloques entrecomillados.
Contenido del vínculo
Actualmente, hay una gran cantidad de contenido para el sitio web de documentación, pero las piezas individuales a menudo no están vinculadas a otros temas relevantes. Los artículos podrían vincularse entre sí para mejorar la visibilidad.