Skip to content

[GOOD FIRST ISSUE] Audit the ENTITY v3.4 Start Here path from a fresh clone #26

Description

Goal

Approach ENTITY as a new developer and follow START_HERE.md from a fresh clone without relying on prior project knowledge.

This is a documentation/usability audit for ENTITY v3.4.0 — Global Passport & Continuous Provenance. You do not need to change protocol code.

Try to answer

  • Can you understand the five core primitives and the Global Passport concept from the linked material?
  • Do the quick-start commands work as written?
  • Can you find the v3.4 Global Passport schema, sealed clean-room kit, domain packages, tests and engineering-evidence ledger without guessing?
  • Can you understand the difference between a core Global Passport and a domain implementation package?
  • Is anything described before it is defined?
  • Are any links stale, circular or unnecessarily deep?
  • Is the difference between BTG-controlled qualification and independent external validation clear?
  • Can you identify a useful first contributor task in under 10 minutes?

Completion evidence

Open a PR with narrowly scoped documentation corrections, or comment with a short numbered usability report identifying exact files/lines and the point of confusion.

Please preserve technical precision rather than simplifying away the authority, evidence, truth and compliance boundaries.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationDocumentation, examples, or developer guidancegood first issueBounded task suitable for a first contributionhelp wantedMaintainers welcome external contribution

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions