Especificação, decisões e relatórios
Os documentos originais do repositório são importados a cada build, com links internos ajustados. Eles preservam o histórico e as ressalvas; a referência gerada mostra o estado atual dos símbolos.
- BASICGOL — Especificação da Linguagem
- BASICGOL — Referência de Palavras-chave e Operadores
- BASICGOL → C: tabela de mapeamento
- BASICGOL — Restrições de Implementação e Decisões
- BASICGOL — Critérios de Aceitação
- BASICGOL — Referência de Tipos e Expressões
- BASICGOL — Controle de fluxo (Fase 3)
- BASICGOL — Relatório de testes da Fase 3 (controle de fluxo)
- Biblioteca padrão BASICGOL (Fase 5)
- 10 — Compilação e compiladores (Fase 6)
- 11 — Matriz de compatibilidade (Fase 6)
- 12 — Relatório da Fase 6: portabilidade, múltiplos compiladores e endurecimento
- 13 — Defeitos encontrados na Fase 6, e o que foi feito
- 14 — Auditoria de compiladores e exemplos (17/11/2026)
- API reference — BASICGOL
- Matriz de funcionalidades — BASICGOL (BG)
- Limitações conhecidas — BASICGOL
- Tutorial rápido (Português) — BASICGOL
- Visão geral · README
Perguntas frequentes
Perguntas frequentes sobre os documentos normativos e históricos do projeto.
Qual é a diferença entre “Projeto” e “Referência”?
A referência é gerada do código atual: assinaturas, expansões, guards e usos em testes. Os documentos do projeto preservam a especificação, as decisões e os relatórios históricos, que podem descrever fases já concluídas.
Um documento histórico vale como estado atual?
Não automaticamente. Quando especificação e código divergirem, a referência gerada mostra o que o fonte faz hoje; o relatório mostra o que foi executado na fase documentada.
Estes documentos são editados pelo gerador?
Não. Eles são importados de docs/ e do README.md a cada build, com links internos ajustados. A fonte versionada continua sendo o arquivo original.
Onde encontro os critérios de aceitação?
Nos documentos numerados: especificação, critérios, relatório de fase e matriz de compatibilidade. Use a navegação lateral; a ordem acompanha o prefixo numérico dos arquivos.
Os mesmos arquivos podem ser listados e reimportados pelo gerador:
ls docs/*.md
python3 tools/gerar_documentacao.py --strict