Esta página contém os detalhes de um projeto de escrita técnica aceito para a temporada de documentos do Google.
Resumo do projeto
- Organização de código aberto:
- SO do Qubes
- Redator técnico:
- luzeal
- Nome do projeto:
- Integração com o QubesOS! Vamos escrever um guia aberto e fácil de usar
- Duração do projeto:
- Duração padrão (3 meses)
Project description
Integração com o QubesOS !
Eu gostaria de criar um guia aberto e materiais relacionados para usuários iniciantes no QubesOS. O objetivo seria introduzir o QubesOS para leigos e manter o guia o mais conciso e compreensível possível, usando analogias, ilustrações e diagramas. Para manter a consistência, usaremos links para recursos confiáveis, incluindo, em primeiro lugar, aqueles presentes no site do QubesOS. Tudo será lançado com uma licença aberta.
Por "independente", quero dizer uma parte do conteúdo que pode existir independentemente do site, por exemplo, como um manual. Ele não equivale à versão off-line do guia. O ideal é que seja criado outro canal para publicar o conteúdo como guia, junto com o site.
Por "aberto", quero dizer um guia que será lançado sob uma licença aberta.
Como isso pode ser feito
Definir o público-alvo
Até hoje, tenho a impressão de que a categoria de usuários que o QubesOS está segmentando não está bem definida. Como o QubesOS pode ajudar jornalistas, advogados, analistas de segurança, desenvolvedores de software e outros? Seria ótimo descrever cenários em que o QubeOS pode ser útil.
Defina as expectativas certas
Também é importante avisar aos novos usuários que o QubesOS exige um bom nível de conhecimento em TI. Há um preço a pagar para usar o QubesOS em termos de usabilidade, especialmente se ele for seu sistema de computação principal. Sobre o mesmo token, há coisas que o QubeOS não funcionam bem (por design), como a aceleração 3D em máquinas virtuais. É importante esclarecer desde o início, não para impedir as pessoas de usá-lo, mas definir exceções para usuários em potencial.
O que é QubesOS e o que não é
Embora o QubesOS seja uma categoria especial de sistema operacional (uma distribuição Xen), seria interessante compará-lo a outros sistemas operacionais com base nas funcionalidades ou na falta deles. Por exemplo, o Windows usa cada vez mais virtualização e sandbox como mecanismos de segurança. É possível usar um diagrama/tabela simples.
As especificações do guia serão definidas com a comunidade.
Quais são as informações mínimas que o guia deve conter? Até que ponto a instalação pode ser simplificada sem comprometer a segurança? Onde deve ficar o limite? Existe uma configuração minimamente viável e segura do QubesOS? Em caso negativo, ele pode ser definido e definido como o destino do guia.
Licença
Pegue uma licença. O respeitado wiki do Archlinux está usando a Licença de Documentação Livre do GNU 1.3 ou posterior. Esta licença é adequada?
Outros clientes
Tornar a documentação do site mais visualmente atraente
As notas podem ser destacadas usando cor vermelha ou amarela para torná-las mais fáceis de notar. Por exemplo, caixas de cores podem ser usadas, como as encontradas no wiki do archlinux. https://wiki.archlinux.org/index.php/Linux_Containers.
É possível usar trechos de texto.
Conteúdo do link
Atualmente, há muito conteúdo para o site de documentação, mas os itens individuais muitas vezes não estão vinculados a outros tópicos relevantes. Os artigos podem ser vinculados uns aos outros para melhorar a capacidade de descoberta.