Skip to content

Conversation

@ChristopherA
Copy link
Contributor

Summary

Complete rewrite of XID tutorials with improved pedagogy based on atomic learning analysis.

Status: 🚧 Work in Progress

Completed

  • Tutorial 01: Creating Your First XID (tested, published)
    • Added Subject-Assertion-Object model explanation
    • Added Known vs String predicates distinction
    • Added Merkle tree explanation for elision
    • 15 atomic learnings covered, 72% hands-on

In Progress

  • Tutorial 02: Building & Publishing Your Identity (refactoring)
    • New focus: dereferenceVia, Open Integrity, GitHub publishing
    • Moving permits content to T03

Planned

  • Tutorial 03: Trust Building with Protected Attestations
  • Tutorial 04: Gordian Clubs (review existing)
  • Tutorial 05: Advanced Key Management (new)

Reference

  • Old tutorials preserved at main:c8bb0a3 (Sept 2025)

Test Plan

  • tests/01-your-first-xid-TEST.sh passes 100%
  • tests/02-building-publishing-TEST.sh (pending refactor)
  • tests/03-trust-building-TEST.sh (pending refactor)
  • tests/04-gordian-clubs-TEST.sh (review)

- Archived old tutorials in development repo
- Fresh start for pedagogically-redesigned tutorial series
- Old content preserved at main:c8bb0a3

Signed-off-by: @ChristopherA <ChristopherA@LifeWithAlacrity.com>
Pedagogically-redesigned tutorial with:
- Subject-Assertion-Object model explanation
- Known vs String predicates distinction
- Merkle tree explanation for elision
- Ed25519 keypair generation
- Encrypted private keys (SSH-like model)
- Provenance marks and signature verification
- 15 atomic learnings covered

Test validated: tests/01-your-first-xid-TEST.sh passes 100%

Signed-off-by: @ChristopherA <ChristopherA@LifeWithAlacrity.com>
Comprehensive test validating all code blocks:
- XID creation with Ed25519 keypairs
- Elision and hash preservation verification
- Signature and provenance validation
- Algorithm verification (Ed25519, Argon2id)

Signed-off-by: @ChristopherA <ChristopherA@LifeWithAlacrity.com>
- Define 8 core terms taught in T01: XID, Subject, Assertion,
  Known/String Predicates, Elision, Provenance Mark, Envelope Digest
- Matches T02 blockquote format for consistency across tutorials
- Placed after Common Questions, before What's Next

Signed-off-by: @ChristopherA <ChristopherA@LifeWithAlacrity.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants