Skip to content

docs: expand content (emergency, FAQ, glossary, guides, community)#1

Merged
scmesh merged 7 commits intoscmesh:mainfrom
Boa-Thomas:main
Apr 20, 2026
Merged

docs: expand content (emergency, FAQ, glossary, guides, community)#1
scmesh merged 7 commits intoscmesh:mainfrom
Boa-Thomas:main

Conversation

@Boa-Thomas
Copy link
Copy Markdown
Contributor

Summary

  • Adds community/process pages: code of conduct, contributing guide, governance, events, post-event reports, fundraising, gallery, ham-radio outreach
  • Deepens technical content: hardware (radios comparison, power consumption, antennas, NanoVNA, solar setup), infrastructure (node roles, RF planning tools, candidate sites), tech wiki, tools page
  • Adds emergency protocols, FAQ, glossary, use cases, security & privacy guidance
  • Merges upstream/main to incorporate the simulado blog post + recent navigation/content updates
  • Adds markdown_extensions (admonition, details, superfences) carried from upstream

Test plan

  • mkdocs build --strict passes locally
  • All 18 pages referenced in nav: (no orphans)
  • Internal cross-links resolve
  • CI build on PR confirms render

claude and others added 5 commits April 17, 2026 23:16
- Nova pagina Protocolos de Emergencia (formato de mensagem, kit 72h, etiqueta)
- Novo Glossario com termos de RF e Meshtastic
- Novo FAQ cobrindo projeto, alcance, uso, hardware, rede e emergencia
- Primeiros Passos com checklist, tabela de parametros e canais padrao SC
- Hardware com comparativo ampliado, antenas, dimensionamento solar e custos
- Infraestrutura com lista de locais candidatos por regiao e plano de manutencao
- mkdocs.yaml: adiciona entradas de navegacao para as novas paginas
Expansoes com pesquisa em docs oficiais Meshtastic, LABRE/RENER/Defesa
Civil SC e referencias de RF.

- hardware.md: tabela com links de fabricante e docs oficiais; consumo
  real por chip (RAK4631 2 uA, Heltec V3 130 mA medio); configuracoes
  de economia (is_power_saving, ls_secs, min_wake_secs); VSWR/NanoVNA
  com tuning, alvos e referencias de testes da comunidade
- infraestrutura.md: secao de ferramentas de planejamento RF (Google
  Earth, HeyWhatsThat, airLink, Radio Mobile, CloudRF, RadioPlanner,
  QGIS); criterios de bom ponto alto; manutencao detalhada com
  cronograma, kit de campo e log de manutencao; procedimento de teste
  de alcance sistematico
- emergencia.md: contatos oficiais 190/192/193/199 com telefones da
  Defesa Civil SC; fluxo de ativacao em crise; integracao formal com
  REER-SC, RENER e LABRE; simulado estadual anual; kit 72h expandido
- primeiros-passos.md: bloco de seguranca inicial; secao de
  atualizacao de firmware; tabelas de interpretacao de RSSI/SNR
- wiki-tecnica.md: protocolo Meshtastic (managed flood, payload,
  hop limit); tabela completa de presets LoRa; regulamentacao Anatel
  com resolucoes e limites EIRP; criptografia AES256-CTR com o que e
  e nao e cifrado; airtime e duty cycle
- seguranca-privacidade.md (novo): modelo de ameaca, o que esta e
  nao esta cifrado, analise de trafego, quando rotacionar PSK
- casos-de-uso.md (novo): trilhas, nautica, rural, eventos, enchentes,
  vizinhanca, educacao; honest "o que a rede nao e boa em"
- ferramentas.md (novo): apps oficiais, CLI Python, mapas,
  planejamento RF, hardware auxiliar (NanoVNA, SDR), automacao
- mkdocs.yaml: inclui Seguranca e Privacidade, Casos de Uso e
  Ferramentas na navegacao
- Eventos e meetups: cadencia, formato e modelo de divulgacao
- Vaquinhas e financiamento: principios, transparencia e prestacao de contas
- Galeria de setups: padrao de submissao e cuidados de privacidade
- Para radioamadores: comparativo Mesh x radioamadorismo, ponte com REER-SC
- Relatorios pos-evento: template, tipos e cadencia de publicacao
- Codigo de conduta: baseado no Contributor Covenant 2.1, adaptado a SC Mesh
- Como contribuir: estilo editorial, fluxo Git/PR, padrao de commit
- Reorganiza nav agrupando paginas de comunidade
…JtTYN

Adiciona paginas de emergencia, FAQ, glossario e expande guias
# Conflicts:
#	docs/hardware.md
#	docs/infraestrutura.md
#	docs/primeiros-passos.md
#	mkdocs.yaml
Comment thread docs/infraestrutura.md Outdated
- **CLIENT_BASE** — nó fixo em casa/escritório; prioriza tráfego de nós favoritos sem exigir ponto alto.
- **CLIENT_MUTE** — CLIENT que não retransmite. Use em áreas já cobertas.
- **ROUTER** — nó fixo em ponto alto, 24/7. Prioriza tráfego alheio.
- **REPEATER** — variante mais enxuta do ROUTER, sem recursos de cliente.
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A opção repeater foi descontinuada na versão 2.7.11, seria bom adicionar essa informação

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Feito: adicionado aviso de descontinuação da role REPEATER a partir do firmware 2.7.11 em infraestrutura.md. Commit 1069a02.

Comment thread docs/primeiros-passos.md Outdated
- **CLIENT** — padrão. Seu rádio pessoal. Use este.
- **CLIENT_MUTE** — como CLIENT, mas não retransmite. Use em áreas já bem cobertas por outros nós.
- **ROUTER** — apenas para nós fixos em ponto alto, ligados 24/7. Não use no seu rádio pessoal.
- **ROUTER_CLIENT** — evite. Reservado para casos específicos.
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ROUTER_CLIENT foi descontinuado, por favor, remover

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Feito: ROUTER_CLIENT removido da lista de roles em primeiros-passos.md e entrada correspondente em glossario.md atualizada para refletir a descontinuação. Commit 1069a02.

Comment thread docs/ferramentas.md Outdated
@@ -0,0 +1,93 @@
# Ferramentas
Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Faça um merge desse ferramentas.md com o recursos.md e aí pode remover o recursos.md

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Feito: links de recursos.md incorporados em ferramentas.md, arquivo recursos.md removido e entrada correspondente retirada do nav em mkdocs.yaml. Commit 1069a02.

…e recursos

- infraestrutura.md: adiciona aviso de descontinuacao da role REPEATER (firmware 2.7.11+)
- primeiros-passos.md: remove item ROUTER_CLIENT da lista de roles
- glossario.md: atualiza entrada ROUTER_CLIENT para refletir descontinuacao
- galeria.md: remove REPEATER do modelo de submissao
- ferramentas.md: incorpora links de recursos.md (site oficial, firmware, site planner, Scadacore, MeshMonitor, Mesh Mapper, AI Responder)
- recursos.md: removido apos merge em ferramentas.md
- mkdocs.yaml: remove entrada de navegacao Recursos

https://claude.ai/code/session_01UJW1a89T4N48qZ3G6eni2L
Atende revisão upstream: REPEATER/ROUTER_CLIENT e merge recursos
@scmesh scmesh self-assigned this Apr 20, 2026
@scmesh scmesh merged commit a8f35a6 into scmesh:main Apr 20, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants