|
Download project-docs/annotation-guide.md from enzoferracini/patchinsight-bertimbau-ptbr: direct link, hf CLI and curl.
- Browser
- Download file 3.35 kB
-
https://huggingface.co/enzoferracini/patchinsight-bertimbau-ptbr/resolve/main/project-docs/annotation-guide.md
- Command line
-
hf download hf://enzoferracini/patchinsight-bertimbau-ptbr/project-docs/annotation-guide.md
-
curl -L -o annotation-guide.md https://huggingface.co/enzoferracini/patchinsight-bertimbau-ptbr/resolve/main/project-docs/annotation-guide.md
3.35 kB
| # Guia de anotação — 0.1.0 | |
| Cada exemplo recebe cinco booleanos independentes. A referência é o que o texto | |
| afirma, sem inferir experiência a partir de cargo, empresa ou tecnologia. | |
| | Rótulo | Positivo | Negativo / fronteira | | |
| |---|---|---| | |
| | `action` | Contribuição identificável realizada: “Investiguei os timeouts.” | “Atuei com tecnologia”, intenções futuras e ações negadas. | | |
| | `context` | Situação, domínio, equipe ou problema explícito: “Na equipe de pagamentos havia falhas.” | Nome de ferramenta isolado; não inferir o domínio. | | |
| | `method` | Meio, técnica, processo ou ferramenta usado/indicado como abordagem: “Abordagem: revisão por pares.” | Lista de competências sem relação com uma abordagem. | | |
| | `result` | Efeito ou entrega identificável: “O acesso foi restabelecido”, “Entreguei o painel.” | Investigação sem conclusão, “bons resultados”, propósito futuro. Não exige números. | | |
| | `measurement` | Quantidade com referente: “Escopo: 12 serviços”, “redução de 20%”, “duas horas”. | “OAuth 2.0”, “Python 3.11”, “2026”, “INC-42”. Número pode medir escopo, sem resultado. | | |
| “Entreguei três relatórios” tem `action`, `result` e `measurement`. | |
| “Investiguei a lentidão” tem `action`, sem entrega ou efeito afirmado. | |
| “O tempo de espera caiu” tem `result`, sem ação pessoal explícita. | |
| “Não implementei cache; corrigi o timeout” contém uma ação realizada na segunda | |
| oração; não aplicar negação à frase inteira. “Pretendo reduzir 20% usando SQL” | |
| tem método e medida explícitos, sem ação realizada nem resultado realizado. | |
| “Trabalho há dois anos com dados” contém medida e contexto, mas uma atividade | |
| vaga não estabelece contribuição específica. A anotação é descritiva; falsidade | |
| ou causalidade de uma alegação não podem ser verificadas por este dataset. | |
| As cláusulas de contexto, abordagem, efeito e escopo podem ocorrer isoladamente | |
| nos exemplos composicionais. “Escopo: 8 jobs” é uma medida, sem presumir entrega | |
| ou situação de negócio. Uma abordagem nominal conta como método mesmo sem verbo | |
| de realização; essa convenção limita a interpretação dos dados. | |
| ## Piloto e lotes | |
| O piloto são os primeiros 50 registros do lote 1. O guia foi fixado antes dos | |
| experimentos; o piloto usa as mesmas definições dos demais registros. A geração | |
| é composicional, com 100 cenários originais e quatro variantes controladas por | |
| cenário. A variante completa e as remoções/negações são deliberadamente | |
| correlacionadas e permanecem no mesmo split. Não são 400 origens independentes. | |
| Revisão feita pela mesma IA: inspecionar as cláusulas de cada cenário quanto a | |
| efeito concreto, contribuição, quantidades, negação e intenção; revisar os | |
| textos renderizados e auditar duplicatas, cobertura e grupos. Histórico por | |
| registro descreve o procedimento realizado, sem alegar um segundo anotador. | |
| Não houve revisão humana nem medida de concordância. | |
| O teste tem arquivo de cenários separado, produzido antes dos experimentos. | |
| Congelar hashes de textos e rótulos; usar só treino/validação em decisões. | |
| O teste final poderá ser lido para relatar erros, nunca para orientar novos dados | |
| ou ajustes da v0.1. Mudanças posteriores exigem outra versão e outro teste. | |