Skip to content

DevIndex: Split Methodology guide into Introduction and Methodology #9234

@tobiu

Description

@tobiu

Description

The current Methodology.md guide for DevIndex has evolved into a comprehensive manifesto covering project motivation, the AI era, funding disparities, and legal disclaimers, in addition to actual scoring and heuristic methodologies. This creates a structural imbalance where the "Why" and the "How" are conflated.

Requirements

  • Create a new Introduction.md guide.
  • Move the following sections from Methodology.md to Introduction.md:
    • Legal Disclaimer
    • Project Motivation & The "Invisibility" Problem (including AI Era & Open Source Sustainability)
    • Technical Feasibility & The GitHub API Challenge (including the 50k cap and 20MB payload rationale)
    • Data Science Use Cases
    • Rich Data & Inclusivity
  • Refine Methodology.md to strictly focus on the "How":
    • Keep "Scoring" (Commits, PRs, Issues, Code Reviews)
    • Keep "Anomaly Detection & Pattern Recognition" (Velocity, Acceleration, Consistency heuristics and Impact Badges)
    • Add details about the Meritocracy Filter algorithm (how threshold.json dynamically rises).
  • Update learn/guides/devindex/tree.json to include Introduction as the first item.

Metadata

Metadata

Assignees

Labels

aidocumentationImprovements or additions to documentation

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions