Skip to content

P3: discover/ directory has no README explaining its schema layout #388

Open
Open
P3: discover/ directory has no README explaining its schema layout#388
Labels
area:discovery-engineDiscovery, classification, enrichment, and recommendation signalsdocumentationImprovements or additions to documentationeffort:SEstimated effort: 3 to 5 engineer-daysgood first issueGood for newcomerspriority:P3Useful optimization or hardening after higher-priority work

Description

@ar27111994
ar27111994
opened on Jul 30, 2026

Summary

discover/ directory contains pipeline.json, schema/, seeds/, source-packs/, and various JSON configs — but no README.md explaining structure or how to add new sources/packs.

Verification

$ ls discover/
official-skills-indexes.json  official-upstreams.json  output/
pipeline.json  recommendation-policy/  schema/  seeds/
selections.json  source-packs/  sources.json
$ ls discover/README.md
(no such file)

Acceptance Criteria

  • discover/README.md exists with directory overview
  • Schema files are referenced with descriptions
  • Source pack registration workflow summarized
  • Linked from CONTRIBUTING.md or docs/README.md

Priority / Effort

Priority: P3 Effort: S

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:discovery-engineDiscovery, classification, enrichment, and recommendation signalsdocumentationImprovements or additions to documentationeffort:SEstimated effort: 3 to 5 engineer-daysgood first issueGood for newcomerspriority:P3Useful optimization or hardening after higher-priority work

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions