sys-intelligence/system-intelligence-benchmark

Add a `WHY.md` File for Each Benchmark

Ouverte

#22 ouverte le 25 nov. 2025

Voir sur GitHub
 (0 commentaire) (0 réaction) (0 personne assignée)TLA (11 forks)auto 404
documentationenhancementgood first issue

Métriques du dépôt

Stars
 (54 étoiles)
Métriques de merge PR
 (Aucune PR mergée en 30 j)

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.

Guide contributeur

Direction de recherche
Lisez les fichiers README existants et le problème #21 référencé pour comprendre le format, puis créez un fichier WHY.md pour chaque dossier de benchmark expliquant son importance et en le liant à partir du README racine.
Stack technique
Aucun
Domaine
documentation
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Récente
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
GitBasic Markdown
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
85