Manual da Garupa

Versão 0.1 · 29 de outubro de 2026.

1. Conheça o projeto

A Garupa é a biblioteca de recursos educacionais para educação digital crítica da InfoCria.

A biblioteca reúne referências para aprender e ensinar sobre tecnologia, educação digital e midiática, privacidade e autonomia digital. Está em cultivo: recebe curadoria, revisão e ampliação contínuas. Professores da rede pública, educadores e facilitadores são públicos prioritários. Rafael Batista, tecnologista educativo, responde pelo projeto, vinculado a Imbariê, Duque de Caxias/RJ.

O catálogo reúne 38 fichas de recursos educacionais em sete categorias. Há seis rotas em piloto. A rota de contas e arquivos tem quatro etapas detalhadas. As demais apresentam roteiros iniciais. A revisão pedagógica com participantes permanece pendente. “Publicado” indica que o conteúdo pode aparecer no site; não significa validação pedagógica.

2. Para consultar e utilizar

1. Abra https://tecnorganico.github.io/infocria-site/garupa/ .
2. Escolha uma categoria ou pesquise um assunto.
3. Use filtros de categoria e tipo, se necessário.
4. Abra a ficha do recurso educacional.
5. Leia objetivos, público, autoria e condições de uso.
6. Consulte a indicação de acessibilidade e os requisitos de acesso.
7. Abra a fonte ou escolha o arquivo que deseja baixar.
8. Planeje a atividade conforme seu grupo e os recursos disponíveis.

Exemplo: procure “senhas”. A ficha “Autenticação: cuide do acesso às contas” aponta ao fascículo do CERT.br. Ela não transfere a autoria para a InfoCria. Leia suas condições antes de reproduzir ou adaptar.

A busca consulta as fichas, não os anexos. Sem JavaScript, navegue pelas categorias e pela lista. O download só começa após sua escolha. Arquivos DOCX/PPTX podem exigir aplicativo compatível.

3. Para percorrer as rotas

1. Abra a seção Rotas para aprender.
2. Leia o aviso de piloto.
3. Escolha uma rota conforme sua necessidade.
4. Consulte objetivos, recursos educacionais e apoios.
5. Na primeira rota, abra uma das quatro etapas.
6. Use exemplos fictícios nas práticas.
7. Confira o resultado e identifique o apoio necessário.
8. Se facilitar um grupo, leia as orientações de mediação.

Não compartilhe senhas, códigos ou documentos pessoais. Pedir ajuda faz parte da aprendizagem. As atividades não geram pontuação nem certificado. A licença CC BY-NC 4.0 abrange os roteiros autorais da seção; os recursos educacionais relacionados mantêm condições próprias.

4. Para sugerir contribuições

1. Use o formulário de sugestões indicado no catálogo.
2. Informe o endereço do recurso.
3. Explique sua utilidade para aprender ou ensinar.
4. Indique autoria e condições de uso conhecidas.
5. Revise os dados pessoais antes de enviar.

A sugestão não entra automaticamente no site. O formulário é externo, no CryptPad. Não há upload público de anexos nem sincronização automática das respostas. Crédito de indicação e autoria da obra são coisas diferentes.

5. Para realizar curadoria

1. Confirme o tema e a utilidade pedagógica.
2. Abra a fonte e registre a data da consulta.
3. Confira autoria e tradução separadamente.
4. Verifique acesso e licença da obra específica.
5. Identifique exigências de conta, conexão ou aplicativo.
6. Examine linguagem, público e limitações de acessibilidade.
7. Cadastre um rascunho pelo Pages CMS.
8. Revise objetivos e instruções com exemplos que não exponham pessoas.
9. Prepare anexos autorizados conforme a documentação técnica.
10. Marque como publicado somente após a revisão editorial.

Não use a licença do rodapé de uma organização para presumir a licença de um PDF. Gratuidade não equivale a permissão de adaptação. Não publique inventários, contatos privados ou arquivos brutos ainda em avaliação.

6. Para editar e publicar

1. Entre no Pages CMS com sua conta autorizada do GitHub.
2. Abra tecnorganico/infocria-site.
3. Confira a branch antes de salvar.
4. Abra Garupa — recursos educacionais, apresentação ou rotas.
5. Preserve IDs e endereços de itens já publicados.
6. Salve o conteúdo revisado.
7. Acompanhe o resultado em GitHub Actions.
8. Confira a página pública após o sucesso.

Salvar na main pode publicar automaticamente. Uma falha de validação ou de testes impede o novo deploy. A última versão publicada permanece. Para trabalho sem publicação, use branch separada. A autorização inicial do painel depende da conta do responsável; este manual não comprova que ela foi realizada.

7. Para manter o código

O site usa Astro, arquivos JSON/Markdown e geração estática no GitHub Pages. A busca usa Pagefind. Consulte README.md, GUIA-PAGES-CMS.md, SECURITY.md, docs/GARUPA.md e docs/tecnico/2026-10-29_DOCUMENTACAO_garupa_v01.md no repositório.

1. Leia AGENTS.md.
2. Confira git status antes de editar.
3. Use uma branch própria.
4. Instale as dependências com pnpm install —frozen-lockfile.
5. Execute pnpm test:content.
6. Execute pnpm build.
7. Para a bateria integrada, execute pnpm test:a11y.
8. Revise o diff e os arquivos gerados.
9. Peça autorização antes de enviar ou publicar quando o escopo exigir.

8. Solução de problemas

• Busca indisponível: navegue pelas categorias; confira se JavaScript e arquivos Pagefind estão disponíveis.
• Sem resultados: reduza o termo, remova filtros e procure no título/autoria. A busca não lê anexos.
• Arquivo não abre: confira formato, conexão e aplicativo. Verifique se há outra versão na ficha.
• Publicação falhou: consulte Actions; confira campos, URLs, IDs, referências e arquivos. Não desative a validação para ocultar erro.
• Mudança não aparece: confira branch, conclusão do deploy e recarregamento. Não confunda salvamento com conclusão da publicação.
• Falta de acesso ao CMS: use a autorização oficial GitHub; não envie senhas ou tokens por mensagem.
• Dificuldade de acessibilidade: procure apoio pelo contato institucional e descreva a barreira sem dados sensíveis. Não há garantia de acessibilidade integral dos anexos.

9. Glossário

• Ficha de recurso educacional: registro que descreve um recurso educacional, com autoria, fonte, condições de uso e orientações.
• Categoria: agrupamento temático.
• Rota: sequência proposta de aprendizagem, em piloto.
• Etapa: atividade detalhada de uma rota.
• Curadoria: seleção, verificação e revisão antes da publicação.
• CMS: painel para editar conteúdo.
• Branch: linha separada de alterações no Git.
• Build: geração dos arquivos do site.
• Deploy: envio da versão gerada à hospedagem.
• Licença: condições que regulam usos de uma obra.
• Texto alternativo: descrição textual de uma imagem relevante.

10. Contato

infocria@proton.me · https://tecnorganico.github.io/infocria-site/#contato

10. Vocabulário institucional

Na InfoCria, recurso educacional é uma produção ou ferramenta selecionada para apoiar processos de ensino e aprendizagem. Seu uso pode ocorrer por iniciativa da pessoa ou com mediação educativa. A curadoria explicita finalidade, autoria, condições de acesso, possibilidades de uso e limites conhecidos.

A seleção prioriza a educação digital crítica e a autonomia individual e coletiva. O recurso educacional não garante autonomia por si só. As condições de acesso, a experiência e as relações educativas também fazem parte desse processo.

• Biblioteca: a Garupa como iniciativa que reúne e organiza recursos educacionais.
• Catálogo: conjunto de fichas da biblioteca.
• Ficha de recurso educacional: registro que descreve um recurso educacional e orienta seu uso.
• Arquivo: documento disponibilizado ou indicado em uma ficha. Uma ficha pode reunir mais de um arquivo.
• Atividade: ação proposta à pessoa que aprende.
• Rota formativa: sequência de aprendizagem que organiza orientações e atividades.
• Etapa: parte de uma rota formativa.

A Garupa reúne recursos com diferentes condições de uso. Não classifica o conjunto como recurso educacional aberto. Consulte as condições de cada ficha e da fonte. Acesso gratuito não equivale a permissão de adaptação ou redistribuição.