Problema resolvido
A produção autoral do OLA pode gerar muitos tipos de materiais: páginas, mapas, decisões, testes, experimentos, protótipos, versões, lacunas de aprendizagem, registros de curadoria e componentes reutilizáveis.
Esta página resolve esse problema separando a área autoral por função: entrada, mapa, organização, perfil, produção, curadoria, decisões, evolução, lacunas e laboratório.
Finalidade e análise
Finalidade
Definir regras práticas para organizar a pasta autor/, orientando onde colocar arquivos, registros e subpastas relacionados à produção, curadoria, experimentação e evolução autoral.
Análise
A pasta autor/ representa uma entidade de atuação. Ela não guarda todo o conteúdo do OLA, mas registra a dimensão autoral da produção: quem cria, por que cria, como decide, como testa, como cura e como evolui os artefatos.
Regra geral da pasta autor/
Portanto, a pergunta principal não é apenas “quem produziu?”, mas: qual é a função principal deste arquivo dentro do OLA?
Estrutura sugerida da pasta autor/
A estrutura abaixo separa a área autoral em páginas estáveis, registros de atuação, laboratório e experimentos.
autor/
├── index_autor.html
├── mapa_autor.html
├── organizacao_autor.html
├── perfil_autor.html
├── producao_autoral.html
├── curadoria_artefatos.html
├── decisoes_autorais.html
├── evolucao_artefatos.html
├── lacunas_autor.html
├── continuidade_operacional_autor.html
└── lab/
├── index_lab_autor.html
├── experimentos_ativos/
│ └── README_experimentos_ativos.html
├── prototipos/
│ └── README_prototipos.html
├── testes/
│ └── README_testes.html
└── componentes/
└── README_componentes.htmlTipos de conteúdo da pasta autor/
| Tipo de conteúdo | Função | Exemplo | Local recomendado |
|---|---|---|---|
| Índice da área | Apresenta a pasta autor/ e seus principais caminhos. | Entrada para produção e curadoria. | autor/index_autor.html |
| Mapa conceitual | Explicita relações entre autor, aprendizagem, governança e artefatos. | Mapa da atuação autoral. | autor/mapa_autor.html |
| Organização física | Define onde colocar arquivos, subpastas e registros. | Esta página. | autor/organizacao_autor.html |
| Perfil autoral | Registra competências, interesses, lacunas e modo de atuação. | Perfil do autor do OLA. | autor/perfil_autor.html |
| Produção autoral | Inventaria páginas, mapas, trilhas, modelos e artefatos produzidos. | Lista de artefatos criados ou mantidos. | autor/producao_autoral.html |
| Curadoria | Registra critérios de revisão, seleção, validação e descarte. | Checklist de curadoria de páginas. | autor/curadoria_artefatos.html |
| Decisão autoral | Explica por que uma página foi criada, movida, alterada ou arquivada. | Decisão de criar uma nova pasta raiz. | autor/decisoes_autorais.html |
| Evolução de artefatos | Acompanha versões, impactos e refatorações. | Atualização de páginas para novo padrão OLA. | autor/evolucao_artefatos.html |
| Lacunas do autor | Registra conhecimentos que o autor precisa aprender para produzir melhor. | Necessidade de estudar JavaScript, D3.js ou responsividade. | autor/lacunas_autor.html |
| Experimentos | Testes temporários, hipóteses, protótipos e provas de conceito. | Teste de grafo, layout, componente, script ou interação. | autor/lab/ |
Critérios de localização
Para decidir se um arquivo fica em autor/ ou em outra pasta, use os critérios abaixo.
| Pergunta de decisão | Se a resposta for sim | Pasta mais provável |
|---|---|---|
| O arquivo registra como o autor produz, decide, cura ou evolui? | É um registro da atuação autoral. | autor/ |
| O arquivo é conteúdo de um tema, área ou domínio? | É conteúdo organizado por contexto de uso. | dominios/ |
| O arquivo define regra geral, padrão ou política do OLA? | É regra de governança. | governanca/ |
| O arquivo define estrutura do sistema, navegação ou arquitetura? | É parte da arquitetura do OLA. | arquitetura/ |
| O arquivo organiza trilhas, objetos, práticas ou avaliação? | É parte do processo educacional. | aprendizagem/ |
| O arquivo registra lacuna, progresso ou perfil do sujeito que aprende? | É registro da entidade aprendiz. | aprendiz/ |
| O arquivo é um teste, protótipo ou experimento ainda instável? | É material de laboratório. | autor/lab/ |
| O arquivo trata do ciclo de vida, entregas ou continuidade do empreendimento OLA? | É parte da gestão evolutiva do projeto. | projeto/ ou autor/, conforme o foco |
Exemplo de decisão prática
Pedido:
"Fazer uma página sobre continuidade operacional do autor."
Análise:
O foco não é a continuidade do projeto inteiro.
O foco é a capacidade do autor continuar produzindo mesmo com viagens,
cansaço, uso do celular, saúde, backlog mental e limitações operacionais.
Decisão:
autor/continuidade_operacional_autor.html
Justificativa:
A página registra uma condição de atuação autoral, não uma regra geral
do sistema nem um plano completo de gestão do projeto.Laboratório do autor
O laboratório é a área para separar o que ainda está em teste do que já está consolidado no OLA. Ele evita misturar páginas estáveis com protótipos e experimentos.
O que entra em autor/lab/
Testes de interface, grafos, componentes, scripts, layouts, provas de conceito, modelos experimentais e páginas temporárias.
O que não deve entrar em autor/lab/
Páginas já consolidadas do OLA, regras gerais de governança, conteúdos finais de domínio ou páginas oficiais de arquitetura.
| Subpasta | Uso | Exemplo |
|---|---|---|
| autor/lab/experimentos_ativos/ | Experimentos em andamento. | Teste de novo modelo de card ou grafo. |
| autor/lab/prototipos/ | Protótipos que podem virar páginas oficiais. | Protótipo de painel de curadoria. |
| autor/lab/testes/ | Testes pequenos e controlados. | Teste de menu, rolagem, tema ou responsividade. |
| autor/lab/componentes/ | Componentes reutilizáveis em avaliação. | Card, modal, breadcrumb, botão de topo, índice móvel. |
Nomeação de arquivos
A nomeação dos arquivos deve favorecer leitura, manutenção e busca. No OLA, nomes simples, descritivos e em letras minúsculas ajudam a manter coerência entre pastas.
| Regra | Aplicação | Exemplo adequado | Evitar |
|---|---|---|---|
| Usar letras minúsculas | Facilita links e evita diferenças entre sistemas. | mapa_autor.html | MapaAutor.html |
| Usar underline para separar termos | Mantém legibilidade do nome. | curadoria_artefatos.html | curadoriaartefatos.html |
| Começar com a função da página | Ajuda a identificar índice, mapa, organização ou registro. | organizacao_autor.html | autor_organizacao_final.html |
| Evitar nomes genéricos | Reduz ambiguidade. | decisoes_autorais.html | pagina1.html |
| Evitar acentos em nomes de arquivos | Reduz problemas de link e hospedagem. | producao_autoral.html | produção_autoral.html |
| Usar README em subpastas técnicas | Explica a finalidade da subpasta. | README_prototipos.html | explicacao.html sem contexto |
Versionamento e evolução
A evolução da área autoral deve registrar mudanças relevantes, impactos e decisões. Nem toda pequena alteração precisa gerar uma página nova, mas mudanças estruturais devem ser documentadas.
Quando registrar evolução
Quando uma página muda de função, quando entra uma nova subpasta, quando uma regra de organização é criada, quando um protótipo vira página oficial ou quando a alteração impacta outras áreas.
Onde registrar evolução
Mudanças da atuação autoral ficam em autor/evolucao_artefatos.html. Mudanças de regra geral devem ser refletidas também em governanca/.
Relações com outras pastas do OLA
| Pasta | Relação com autor/ | Exemplo de uso |
|---|---|---|
| aprendiz/ | Registra o sujeito que aprende, suas lacunas e progresso. | Uma lacuna do autor pode virar registro de aprendiz. |
| aprendizagem/ | Organiza trilhas, objetos, práticas e avaliação. | Uma dificuldade autoral pode gerar uma trilha de aprendizagem. |
| governanca/ | Define regras e padrões que orientam a produção autoral. | Regra de blocos finais, navegação, semântica e versionamento. |
| arquitetura/ | Define estruturas, navegação, padrões e componentes do sistema. | O autor cria uma página sobre sistema de navegação do OLA. |
| dominios/ | Recebe conteúdos organizados por área de conhecimento ou contexto. | Autor produz conteúdo de eletricidade, saúde ou sistema. |
| projeto/ | Organiza entregas, método, ciclo de vida e continuidade do empreendimento. | Produção autoral alimenta entregas do projeto OLA. |
| assets/ | Guarda recursos estáticos reutilizáveis. | Imagens, scripts, CSS, ícones e componentes compartilhados. |
Checklist de uso da pasta autor/
Antes de criar ou mover um arquivo para autor/, use este checklist.
Checklist de localização
- O foco principal é a atuação do autor?
- O arquivo registra produção, decisão, curadoria ou evolução?
- O conteúdo não pertence melhor a um domínio específico?
- O conteúdo não é uma regra geral de governança?
- O conteúdo não é apenas um protótipo temporário?
Checklist de maturidade
- É uma página estável?
- É um experimento?
- É um registro de decisão?
- Precisa de link no índice da área?
- Precisa ser citado em governança ou projeto?
Páginas relacionadas
Como esta página é de referência e organização, ela termina com páginas relacionadas, e não com “Próximos passos”.
index_autor.html
Entrada da áreaApresenta a pasta autor/ como área de produção, curadoria, laboratório e evolução de artefatos.
mapa_autor.html
Mapa conceitualExplicita relações entre autor, aprendizagem, artefatos, curadoria, governança, projeto e evolução.
governanca/
Regras geraisÁrea onde ficam as regras canônicas que orientam organização, navegação, semântica, versionamento e evolução do OLA.
projeto/
Gestão evolutivaÁrea que organiza o OLA como empreendimento em evolução, com método, entregas, ciclos, continuidade e valor.
aprendiz/
Sujeito que aprendeÁrea complementar quando a atuação autoral gera lacunas, necessidades, trilhas ou acompanhamento de aprendizagem.
arquitetura/
Estrutura do OLAÁrea relacionada quando a autoria produz padrões, navegação, componentes, modelos estruturais ou páginas sistêmicas.