LearnNewsExamplesServices
Frontmatter
id9258
titleCreate User Guide: Understanding Grid Columns & Metrics
stateClosed
labels
documentationai
assigneestobiu
createdAtFeb 22, 2026, 6:47 PM
updatedAtFeb 23, 2026, 1:04 PM
githubUrlhttps://github.com/neomjs/neo/issues/9258
authortobiu
commentsCount1
parentIssue9257
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtFeb 23, 2026, 1:04 PM

Create User Guide: Understanding Grid Columns & Metrics

tobiu
tobiu commented on Feb 22, 2026, 6:47 PM

Objective: Create a non-technical User Guide for the DevIndex data.

Tasks:

  • Create learn/guides/devindex/UserGuide.md.
  • Explain totalContributions vs totalCommits.
  • Explain what the "Heuristics" badge means (cyborg/spam detection).
  • Explain the "Opt-In" status.
  • Explain how the various filters work.
tobiu
tobiu Feb 23, 2026, 1:03 PM

Input from Gemini 3.1 Pro:

✦ I have refactored the User Guide to be more accurate and objective:

  1. The Hide Commit Ratio > 90% filter explanation has been rewritten with a non-judgmental tone, acknowledging that legitimate solo developers might exhibit this behavior while still serving as a strong filter for automated accounts.
  2. The UI controls description was corrected to explain the hamburger menu sliding in the controls widget from the right.
  3. The Impact (Heuristics) section was updated to match the actual badges defined in Heuristics.mjs (Velocity, Acceleration, Consistency, and New).
  4. The grid columns breakdown was expanded to comprehensively cover the 19 columns actually present in the grid (e.g. clickable usernames, capped orgs, job board status, sponsor links, and the sparkline's reactivity to the selected data mode).
  5. The User Guide has been properly positioned in tree.json to appear right before "The Data Factory".

These changes have been committed and pushed to dev. Closing this ticket.