GENEALOGIX Examples

This directory contains complete, working GENEALOGIX archives demonstrating various features and use cases. Each example is designed to teach specific concepts and provide practical templates for real genealogy research.

Learning Path

For Beginners

1. Minimal - Start with the basics

   • Smallest valid archive
   • Required fields only

2. Basic Family - Simple nuclear family

   • Core relationships
   • Easy to understand

3. Complete Family - Recommended starting point

   • Most entity types demonstrated
   • Complete evidence chains
   • Real-world family structure

Real-World Scale

1. Westeros: A Song of Ice and Fire - Large-scale archive
   • 790+ persons across 70+ houses
   • Full evidence chains with 1,800+ assertions
   • 200+ custom vocabulary types
   • Demonstrates every GLX feature at scale

Advanced Concepts

1. Single-File - Single-file archives

   • All entities in one file
   • Portable format

2. Assertion Workflow - Evidence documentation

   • Direct properties vs assertion-backed properties
   • Complete evidence chain pattern
   • Iterative research workflow

3. Temporal Properties - Time-changing values

   • Properties that change over time
   • Occupations, residences, names
   • Date-stamped values

4. Participant Assertions - Event participants

   • Assertion-based participant roles
   • Evidence for event participation

Example Descriptions

Example	Focus	Use Case
Minimal	Essentials	Smallest valid archive
Basic Family	Relationships	Nuclear family structure
Complete Family	All features	Comprehensive demonstration
Single-File	Portability	Simple sharing/backup
Assertion Workflow	Evidence chains	Direct vs assertion-backed properties
Temporal Properties	Time-changing data	Changing occupations/names
Participant Assertions	Event participation	Evidence-based participants
Westeros	Scale & custom vocabularies	790+ persons, 200+ custom types, full evidence chains

Validation

glx validate examples/complete-family/
# All examples pass validation

Contributing

To add new examples, see the Contributing Guide.

References

• GENEALOGIX Specification
• CLI Tool
• JSON Schemas
• Contributing Guide