sys-intelligence/system-intelligence-benchmark

Add a `WHY.md` File for Each Benchmark

Aberta

#22 aberto em 25 de nov. de 2025

Ver no GitHub
 (0 comentário) (0 reação) (0 responsável)TLA (11 forks)auto 404
documentationenhancementgood first issue

Métricas do repositório

Stars
 (54 estrelas)
Métricas de merge de PR
 (Nenhuma PRs mesclada em 30d)

Description

Currently, the root-level README lists all benchmarks with a brief one-liner description. Each benchmark’s folder contains a large README where the motivation and rationale are buried within the details.

We should create a dedicated WHY.md file inside each benchmark’s folder. This file should explain:

  • Why the benchmark matters
  • How it fits into our broader vision of system intelligence

See #21 for a similar file

We should then link each WHY.md file from the corresponding bullet point in the root README.

Guia do colaborador

Direção de pesquisa
Leia os arquivos README existentes e a issue #21 referenciada para entender o formato, depois crie um WHY.md para cada pasta de benchmark explicando sua importância e vinculando a partir do README raiz.
Pilha de tecnologia
None
Domain
documentation
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Recente
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
GitBasic Markdown
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
85