Skip to content

README e metodologia: vocabulário e ordem das seções - #8

Merged
marcosbeto merged 1 commit into
mainfrom
revisao-texto-v020
Aug 18, 2026
Merged

README e metodologia: vocabulário e ordem das seções#8
marcosbeto merged 1 commit into
mainfrom
revisao-texto-v020

Conversation

@marcosbeto

Copy link
Copy Markdown
Contributor

Duas revisões de texto na documentação da v0.2.0, saídas da leitura do README depois da rodada. Nenhum dado, nota ou artefato é tocado — só prosa e um comentário de código.

1. "fabricante" → "empresa"

Quatro ocorrências, todas introduzidas na própria v0.2.0. Duas razões:

  • Estilo: "fabricante" evoca manufatura física (fabricante de carros, de eletrodomésticos) e destoa do resto do texto quando o assunto é modelo de linguagem.
  • Consistência: "empresa" já é o termo do projeto para quem cria o modelo — é o campo do APRESENTACAO e a coluna do leaderboard (empresa: 'OpenAI', 'Anthropic', 'Moonshot').

Vale explicar por que não usamos "provedor", que seria o candidato óbvio: neste repositório a palavra tem significado técnico próprio e diferente — quem serve o modelo (Fireworks, Amazon Bedrock, Alibaba). É a distinção que a DECISOES.md D9 define ("rodadas pelo mesmo modelo em provedores diferentes são medições distintas") e que o campo rotas do leaderboard passou a expor nesta release. Usar "provedor" para quem cria o modelo criaria ambiguidade justo no conceito mais delicado da metodologia.

2. "Quem mantém" mais para o fim

A seção sai de logo depois do held-out e passa a vir imediatamente antes de "Como contribuir".

Quem chega ao repositório procura primeiro os resultados e a metodologia; a declaração de conflito de interesse (o bncc.dev é mantido pela Profy, que opera produtos com LLM sobre BNCC) é contexto institucional, e emenda melhor na seção sobre contribuição. O conteúdo da seção não muda — incluindo o registro de que a triagem encontrou uma habilidade com texto inventado publicada no próprio site da Profy.

Ordem resultante:

Resultados → Um mês depois → held-out → O que é medido
→ Estrutura → Uso → Quem mantém → Como contribuir → Licenças

Substitui o #7, fechado para juntar as duas revisões num PR só.

🤖 Generated with Claude Code

Duas revisões de texto na documentação da v0.2.0. Nenhum dado, nota ou
artefato é tocado.

1. "fabricante" -> "empresa" (4 ocorrências, todas introduzidas na v0.2.0).
   "Fabricante" evoca manufatura física e destoa do texto. "Empresa" é o
   termo que o projeto já usa para quem cria o modelo: é o campo do
   APRESENTACAO e a coluna do leaderboard. Não dá para usar "provedor", que
   neste repositório significa outra coisa — quem SERVE o modelo (Fireworks,
   Amazon Bedrock, Alibaba), distinção que a D9 define e que o campo `rotas`
   do leaderboard expõe.

2. "Quem mantém" passa a vir logo antes de "Como contribuir", perto do fim.
   Quem chega ao repositório procura resultados e metodologia primeiro; a
   declaração de conflito de interesse é contexto institucional e emenda
   melhor na seção de contribuição.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@marcosbeto
marcosbeto merged commit dafebbc into main Aug 18, 2026
1 check passed
@marcosbeto
marcosbeto deleted the revisao-texto-v020 branch August 18, 2026 13:27
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.

1 participant