OLA Semântica dos Blocos de Página

Semântica dos Blocos de Página do OLA

Esta página define o significado dos blocos recorrentes usados nas páginas do OLA, especialmente a diferença entre Próximos passos, Próximas ações, Páginas relacionadas, Artefatos criados, Pendências e Histórico de evolução.

O objetivo é evitar que uma mesma seção misture leitura, navegação, tarefa pendente, artefato já produzido e histórico de mudança. Esta versão também referencia a regra CONT-08, que define qual bloco deve fechar a página conforme sua função principal.

Governança Semântica Blocos de página Próximos passos Navegação Evolução

1. Problema resolvido

Em várias páginas do OLA, o bloco Próximos passos passou a cumprir funções diferentes: às vezes indicava tarefas pendentes; às vezes indicava páginas para ler; às vezes listava artefatos já criados; e às vezes funcionava como navegação relacionada.

Esta página resolve esse problema definindo a semântica de cada bloco e estabelecendo uma regra para separar ação, leitura, navegação, artefato concluído, pendência e histórico.
Intenção Bloco correto Uso claro Atualização Governança

2. Finalidade e análise

Finalidade

Para que serve?

Para padronizar os blocos recorrentes das páginas do OLA e evitar ambiguidades entre o que há a fazer, o que há para ler, o que já foi criado e o que ficou como histórico.

Análise

Qual distinção é necessária?

A página distingue ação pendente, recomendação, navegação relacionada, artefato criado, pendência, histórico, continuidade de leitura e acompanhamento.

Esta página deve orientar páginas novas e também servir para revisar páginas já produzidas em aprendiz/, autor/, arquitetura/, governanca/, dominios/, fundamentos/ e demais áreas.

3. Regra central

Regra central: cada bloco de página deve ter uma função semântica única. Se a seção mistura tarefas pendentes, links de leitura e artefatos já criados, ela deve ser dividida em blocos separados.

Assim, o OLA evita que o leitor confunda:

  • o que ainda deve ser feito;
  • o que já foi feito;
  • o que deve ser consultado;
  • o que está pendente ou bloqueado;
  • o que foi parte da evolução histórica;
  • o que é apenas recomendação de continuidade.
Se ainda precisa ser feito:
usar “Próximas ações”.

Se já existe e serve para navegação:
usar “Páginas relacionadas”.

Se já foi produzido como resultado:
usar “Artefatos criados”.

Se é problema aberto:
usar “Pendências”.

Se registra mudança anterior:
usar “Histórico de evolução”.

Se orienta o uso contínuo:
usar “Acompanhamento” ou “Recomendações”.

4. O significado de “Próximos passos”

No OLA, Próximos passos deve ser usado como expressão geral apenas quando o bloco ainda está em fase inicial ou quando reúne uma orientação breve de continuidade. Em páginas mais maduras, o ideal é substituir ou dividir esse bloco.

Definição recomendada: “Próximos passos” é um bloco transitório de continuidade. Quando houver mistura de ação, leitura, artefato e histórico, ele deve ser desdobrado em blocos semanticamente mais precisos.
Situação Bloco adequado Exemplo
Ainda precisa ser feito. Próximas ações Criar modelo_registro_aprendiz_autor.html.
Já foi feito e pode ser consultado. Páginas relacionadas Ler evidencias_aprendizagem.html.
Foi produzido como resultado desta página ou ciclo. Artefatos criados trilhas_do_aprendiz.html criado.
Há problema ainda não resolvido. Pendências Revisar links quebrados.
Foi decisão ou mudança anterior. Histórico de evolução Seção renomeada em 18/05/2026.
É sugestão, não obrigação. Recomendações Considerar criar versão pública e privada.

5. Separação recomendada dos blocos

Quando uma página está mais madura, o bloco genérico “Próximos passos” pode ser substituído por uma estrutura mais clara.

Ação

Próximas ações

Lista o que ainda precisa ser feito. É o bloco mais próximo de um backlog local da página.

Leitura

Páginas relacionadas

Lista páginas já existentes que ajudam a ler, navegar ou aprofundar o assunto.

Resultado

Artefatos criados

Lista páginas, modelos, mapas, trilhas, grafos ou decisões já produzidas.

Problema

Pendências

Lista lacunas, erros, dúvidas abertas, bloqueios, decisões ainda não tomadas ou inconsistências.

Memória

Histórico de evolução

Registra mudanças já feitas, razões de alteração e marcos relevantes.

Orientação

Recomendações

Sugere caminhos possíveis, sem necessariamente indicar tarefa obrigatória.

6. Regra de fechamento CONT-08

A regra CONT-08, registrada no quadro_regras_ola.html, define que o último bloco da página deve refletir a função principal do artefato. Assim, o encerramento da página não é apenas uma escolha visual: ele orienta a ação, a consulta, a navegação ou a memória da evolução.

CONT-08 — O bloco final da página deve refletir sua função principal.
Páginas operacionais devem terminar com Próximas ações. Páginas de referência, regra, fundamento ou consulta devem terminar com Páginas relacionadas. Páginas que registram evolução podem terminar com Histórico de evolução ou Páginas relacionadas, conforme o objetivo principal seja memória ou navegação.
Tipo de página Bloco final recomendado Motivo Exemplo no OLA
Página operacional Próximas ações Fecha com o que deve ser executado. Página de planejamento, acompanhamento, backlog ou revisão operacional.
Página de referência, regra, fundamento ou consulta Páginas relacionadas Fecha oferecendo navegação, aprofundamento e continuidade de leitura. Quadro de regras, fundamento conceitual, página de consulta ou glossário.
Página de evolução, histórico ou acompanhamento Histórico de evolução ou Páginas relacionadas Fecha preservando memória ou orientando a continuidade da navegação. Página de evolução do OLA, acompanhamento do aprendiz ou registro de mudanças.
Regra prática: se a página termina com “Próximas ações”, o leitor entende que deve executar. Se termina com “Páginas relacionadas”, o leitor entende que deve consultar ou navegar. Se termina com “Histórico de evolução”, o leitor entende que a memória da mudança é o fechamento principal.

7. Tabela dos blocos recorrentes

Bloco Função semântica Pergunta que responde Quando atualizar
Problema resolvido Explicita a dificuldade que a página resolve. Que problema esta página resolve? Quando o escopo da página mudar.
Finalidade Define para que a página existe. Para que serve esta página? Quando a página ganhar novo uso.
Análise Explica a distinção ou raciocínio que estrutura a página. O que precisa ser compreendido ou diferenciado? Quando a modelagem conceitual evoluir.
Como ler esta página Orienta a leitura e o uso. Como devo usar este conteúdo? Quando a página ficar mais complexa.
Próximas ações Lista tarefas pendentes ou recomendadas para execução. O que ainda precisa ser feito? Quando uma ação for concluída, removida ou criada.
Páginas relacionadas Lista páginas já existentes para leitura ou navegação. O que posso consultar? Quando nova página relacionada for criada ou removida.
Artefatos criados Lista resultados já produzidos. O que já foi feito? Quando uma ação virar artefato concluído.
Pendências Lista problemas, lacunas ou bloqueios. O que ainda está em aberto ou com problema? Quando uma pendência surgir ou for resolvida.
Histórico de evolução Registra mudanças, decisões e marcos anteriores. O que mudou e por quê? Quando uma mudança relevante for feita.
Recomendações Sugere caminhos possíveis, não necessariamente obrigatórios. O que pode ser conveniente fazer? Quando surgirem alternativas ou critérios novos.
Acompanhamento Mostra estado, progresso, revisão e continuidade. Onde estamos e como continuar? Em revisões periódicas ou por ciclo de trabalho.
Critérios de qualidade Define como avaliar a página ou artefato. Como sei se está bom? Quando os critérios de governança evoluírem.
Critério de término Define quando uma etapa, trilha ou página está concluída. Quando termina? Quando o objetivo ou escopo mudar.
Bloco final da página Fecha a página conforme sua função principal: execução, consulta/navegação ou memória de evolução. Qual é a melhor forma de encerrar esta página? Quando a função da página mudar ou quando uma página deixar de ser operacional e passar a ser referência.
Privacidade Define classificação de exposição. Pode ser público, interno ou privado? Antes de publicar ou compartilhar.

8. Ciclo de atualização dos blocos

Quando uma ação é concluída, ela não deve permanecer indefinidamente em “Próximas ações”. Ela muda de estado e deve migrar para outro bloco.

Próxima ação Ação realizada Artefato criado Página relacionada Histórico
Estado do item Onde fica Exemplo
Precisa ser feito. Próximas ações Criar acompanhamento_aprendiz.html.
Foi feito. Artefatos criados acompanhamento_aprendiz.html criado.
Serve para navegação futura. Páginas relacionadas Consultar acompanhamento_aprendiz.html.
Foi mudança importante. Histórico de evolução Em 18/05/2026, a página foi criada para acompanhar o aprendiz.
Não foi resolvido. Pendências Falta atualizar links no índice.
Regra de manutenção: uma página madura não deve manter ações concluídas no bloco “Próximas ações”.

9. Exemplos de uso

Exemplo 1 — antes da conclusão

Próximas ações
- Criar evidencias_aprendizagem.html.
- Criar acompanhamento_aprendiz.html.
- Atualizar index_aprendiz.html com os novos links.

Exemplo 2 — depois da conclusão

Artefatos criados
- evidencias_aprendizagem.html
- acompanhamento_aprendiz.html

Páginas relacionadas
- evidencias_aprendizagem.html
- acompanhamento_aprendiz.html
- trilhas_do_aprendiz.html

Próximas ações
- Revisar index_aprendiz.html.
- Atualizar mapa_aprendiz.html, se necessário.

Exemplo 3 — quando há problema aberto

Pendências
- Verificar se todos os links relativos estão corretos.
- Confirmar se a página pertence a aprendiz/ ou governanca/.
- Revisar privacidade antes de publicar exemplos reais.

Exemplo 4 — quando há sugestão, mas não tarefa obrigatória

Recomendações
- Considerar criar uma versão resumida para leitura rápida.
- Avaliar se esta página deve gerar um modelo reutilizável.
- Verificar se vale criar um grafo conceitual sobre os blocos.

10. Critérios de qualidade dos blocos

Univocidade

O bloco tem uma função clara?

A seção não deve misturar tarefa, leitura, resultado e histórico.

Atualidade

O conteúdo está no estado certo?

Ação concluída deve sair de “Próximas ações” e migrar para outro bloco.

Rastreabilidade

É possível saber o que aconteceu?

Mudanças importantes devem aparecer em histórico ou acompanhamento.

Navegação

Links de leitura estão separados?

Páginas relacionadas devem ser links de consulta, não tarefas pendentes.

Continuidade

Há ação retomável?

Próximas ações devem ser pequenas, concretas e executáveis.

Governança

Segue o padrão do OLA?

A página deve usar nomes de blocos coerentes em todas as áreas do site.

11. Modelo recomendado para final de página

Para páginas maduras, recomenda-se substituir o bloco único “Próximos passos” por uma composição mais clara. Além disso, pela regra CONT-08, o último bloco deve ser escolhido conforme a função principal da página.

<section id="artefatos-criados">
  <h2>Artefatos criados</h2>
  <ul>
    <li><a href="pagina_criada.html">pagina_criada.html</a></li>
  </ul>
</section>

<section id="paginas-relacionadas">
  <h2>Páginas relacionadas</h2>
  <ul>
    <li><a href="pagina_relacionada.html">pagina_relacionada.html</a></li>
  </ul>
</section>

<section id="proximas-acoes">
  <h2>Próximas ações</h2>
  <ul>
    <li>Atualizar o índice da área com esta página.</li>
    <li>Revisar links e privacidade antes de publicar.</li>
  </ul>
</section>

<section id="pendencias">
  <h2>Pendências</h2>
  <ul>
    <li>Confirmar se há páginas antigas a revisar.</li>
  </ul>
</section>

Modelo de fechamento por tipo de página

Página operacional:
1. Pendências
2. Páginas relacionadas
3. Próximas ações

Página de referência, regra, fundamento ou consulta:
1. Artefatos criados, se houver
2. Próximas ações, se houver
3. Páginas relacionadas

Página de evolução, histórico ou acompanhamento:
1. Próximas ações, se houver
2. Páginas relacionadas
3. Histórico de evolução
   ou
3. Páginas relacionadas, quando a navegação for o fechamento desejado

Em páginas simples, é aceitável manter apenas “Próximos passos”, desde que o conteúdo seja curto e claramente orientado à continuidade.

12. Leitura M0–M3

Nível Leitura da semântica dos blocos Exemplo
M0 Bloco concreto dentro de uma página. Seção “Próximas ações” em uma página do Aprendiz.
M1 Modelo aplicado de organização da página. Padrão de final de página com ações, links e artefatos.
M2 Metamodelo dos blocos recorrentes do OLA. Distinção entre ação, navegação, histórico e pendência.
M3 Princípio de governança semântica. Cada bloco deve ter função explícita para reduzir ambiguidade; o bloco final deve refletir a função principal da página, conforme CONT-08.

13. Impactos em páginas existentes

Esta regra impacta páginas que usam “Próximos passos” como mistura de tarefa, link, leitura e artefato criado.

Área Páginas que podem ser revisadas Ajuste sugerido
aprendiz/ iniciacao_ola_minimo, trilhas_do_aprendiz, evidencias, acompanhamento, aprendiz_autor. Separar próximas ações de páginas relacionadas.
autor/ index_autor e páginas de produção. Distinguir produção pendente, artefato criado e curadoria.
arquitetura/ mapa_arquitetura, sistema_navegacao, gps cognitivo. Separar leitura arquitetural de ações de atualização.
governanca/ quadro_regras, estrutura física, mapas de governança. Registrar regras criadas, pendências e histórico.
dominios/ índices, mapas e organizações de domínio. Separar páginas do domínio, páginas relacionadas e ações de manutenção.
Não é necessário corrigir tudo de uma vez. A regra pode ser aplicada gradualmente, nas páginas novas ou nas próximas revisões de páginas existentes.

14. Próximas ações

Como esta é uma página de governança, as ações abaixo são tarefas reais para integrar esta regra ao OLA.

Quando essas ações forem executadas, devem sair deste bloco e migrar para “Artefatos criados”, “Páginas relacionadas” ou “Histórico de evolução”, conforme o caso.

↑ topo