Contribuir
Participe na construção do aOS
O angolanOS é um esforço nacional aberto. Precisa de engenheiros, linguistas, professores e peritos de segurança — e cada contribuição segue as mesmas regras, venha de onde vier.
Quem pode contribuir
Engenharia de sistemas e software
Empacotamento Debian, integração contínua, hardenização do kernel, criptografia e infraestrutura.
Linguística e tradução
Especialistas em línguas bantu para o esforço de localização profunda do sistema.
Educação e UX/UI
Desenho das interfaces adaptadas e da suite escolar da edição Educação.
Padrão de commits
Usamos Conventional Commits adaptados a uma distribuição estatal, escritos em português. O formato é obrigatório e é validado automaticamente.
<tipo>(<escopo>): <Descrição Curta>feat(locale): Adicionar catálogo base do Umbundu
sec(kernel): Restringir chamadas de sistema no perfil defesa
chore(apt): Automatizar assinatura do mirror nacionalA descrição curta tem no máximo 50 caracteres e é escrita em português.
Escopos válidos
- kernel
- init
- apt
- installer
- theme
- locale
- build
- iso
- desktop
- server
- defesa
| Tipo | Utilização |
|---|---|
| feat | Nova funcionalidade — nova língua bantu, novo componente de sistema |
| fix | Correcção de erro |
| sec | Correcção de segurança ou hardenização — CVEs, SELinux |
| docs | Apenas documentação |
| style | Formatação e estilo de código ou de tema (Tema Mwangolé) |
| refactor | Refactorização de código |
| perf | Melhoria de desempenho |
| test | Adição ou correcção de testes |
| chore | Build, CI/CD, mirror APT e restante infraestrutura |
Como submeter código
- 1
Derive o repositório
Crie um fork, ou uma branch dedicada se tiver permissões de escrita — por exemplo `feat/locale-umbundu` ou `sec/selinux-profile`.
- 2
Escreva o código e os commits
Siga o padrão de commits em português e as regras de estilo. Todos os scripts `.sh` começam com `#!/bin/bash`, incluem `set -euo pipefail` e passam no shellcheck.
- 3
Valide localmente
Corra as validações do projecto antes de submeter. Se estiver a empacotar software, garanta que o build é reproduzível.
- 4
Submeta o Merge Request
Um engenheiro fará a revisão por pares. Código em `infra/pki_hsm/` e `docs/arquitectura/` exige aprovação de dois mantenedores principais.
# Sintaxe de todos os ficheiros de tradução
.github/skills/validate-po-files.sh
# Shellcheck em todos os scripts
.github/hooks/pre-commit-shellcheck.sh
# Build local rápido de um pacote Debian
debuild -us -ucContribuir com tradução
As traduções vivem em ficheiros po/gettext na pasta src/locales/, organizados por código ISO 639-2/3. Respeite as regras de concordância e pluralização das classes nominais de cada língua — uma tradução literal do português produz frases gramaticalmente inválidas em Bantu.
pt_AO
Português de Angola
umb
Umbundu
kmb
Kimbundu
kng
Kikongo
cjk
Tchokwe
luw
Luvale
ngo
Nganguela
Nova terminologia técnica é submetida a validação por falantes nativos antes de entrar no catálogo. A correcção morfossintáctica de uma tradução não é aferível por quem não fala a língua, pelo que este passo não é dispensável.
Encontrou uma vulnerabilidade?
Não abra uma issue pública. Uma vulnerabilidade divulgada antes da correcção põe em risco sistemas do Estado. Comunique-a de forma confidencial pelo canal de divulgação responsável.
Política de segurançaO guia completo está em CONTRIBUTING.md no repositório do projecto.