Como Contribuir
O PacketWiki é um projeto 100% aberto e colaborativo. Qualquer pessoa pode adicionar, corrigir ou melhorar o conteúdo — seja abrindo um Pull Request no GitHub ou enviando sugestões por e-mail.
Formas de Contribuir
1. Editar uma página existente
Em qualquer página, clique no link "Editar esta página no GitHub" no rodapé. Isso abre o arquivo direto no GitHub onde você pode propor alterações via Pull Request — sem precisar clonar o repositório.
2. Adicionar nova página via GitHub
- Faça um fork do repositório em github.com/EmersonRicard0/packetwiki
- Clone o fork localmente:bash
git clone https://github.com/SEU_USUARIO/packetwiki.git cd packetwiki npm install npm run docs:dev - Crie o arquivo
.mdno diretório correto (ex:docs/pt/switches/cisco/catalyst-2960.md) - Use o template de equipamento abaixo
- Adicione a entrada no sidebar em
docs/.vitepress/sidebars/pt.ts - Abra um Pull Request descrevendo o que foi adicionado
3. Reportar erro ou sugestão via GitHub
Abra uma Issue no GitHub descrevendo o problema ou sugestão.
4. Enviar conteúdo por e-mail
Prefere contribuir sem usar o GitHub? Sem problema! Envie o conteúdo para:
Formatos aceitos por e-mail:
- Arquivo
.md(Markdown) - Documento de texto simples (
.txt) - Texto no corpo do e-mail
- Arquivo Word ou PDF (iremos converter)
Inclua no e-mail:
- Equipamento: fabricante e modelo
- Firmware/versão testada (quando souber)
- Seu nome (para crédito na página, se desejar)
Template de Equipamento
Ao adicionar uma nova página de equipamento, use esta estrutura:
markdown
# Fabricante Modelo — Nome do Equipamento
Breve descrição do equipamento, seu posicionamento no mercado e casos de uso.
## Especificações Técnicas
| Característica | Valor |
|----------------|-------|
| Processador | ... |
| RAM | ... |
| Interfaces | ... |
| Sistema Operacional | ... |
| Firmware testado | ... |
## Acesso Inicial
### Padrões de fábrica
| Parâmetro | Valor |
|-----------|-------|
| IP | ... |
| Usuário | ... |
| Senha | ... |
### Passo a passo
...
## Reset de Fábrica
...
## Configuração Básica
...
## Comandos Úteis / Referência Rápida
| Objetivo | Comando |
|----------|---------|
| ... | ... |
## Problemas Comuns
...
## Veja Também
- Links relacionadosRegras de Contribuição
- Escreva de forma clara e objetiva
- Sempre teste os comandos antes de publicar
- Indique a versão do firmware/software quando relevante
- Use blocos de código (
```) para todos os comandos CLI - Sem promoção comercial — o conteúdo deve ser técnico e neutro
- Respeite a estrutura de diretórios existente
Dúvidas?
- Abra uma discussão no GitHub
- Ou envie um e-mail para silvaemerson797@gmail.com