Como contribuir¶
O RIAC é mantido pela comunidade. Você pode contribuir mesmo sem usar Git no dia a dia.
Sem usar Git¶
Use um dos formulários de issue do repositório:
- Sugerir um recurso — para indicar uma ferramenta, base ou referência de CTI que falta no catálogo.
- Sugerir um verbete — para propor um conceito, modelo ou prática que mereça um verbete.
Você também pode clicar no ícone de lápis (✎) no canto superior direito de qualquer página deste site para editá-la diretamente no GitHub — isso abre um Pull Request pronto para revisão, sem precisar clonar o repositório.
Usando Git e Pull Requests¶
- Leia o
CLAUDE.mdna raiz do repositório: ele define o escopo do projeto, o template de verbete e o modelo de dados do catálogo. - Crie uma branch a partir de
maine faça suas alterações. - Rode
zensical buildlocalmente para confirmar que o site compila. - Abra um Pull Request. O CI de qualidade (links, schema, markdownlint, ortografia, build) roda automaticamente.
- Um mantenedor revisa e mescla.
Regras que valem para qualquer contribuição¶
- Só material TLP:CLEAR. Nunca inclua amostras de malware ou IOCs sensíveis — aponte para quem já hospeda isso com os controles adequados.
- Cada recurso do catálogo tem uma única categoria principal; use
tagspara aspectos secundários. As regras de desambiguação entre categorias estão noCLAUDE.md. - Cite fontes. Todo verbete precisa de ao menos uma referência verificável; não invente dados, datas ou atribuições.
Veja o guia completo em
CONTRIBUTING.md.