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
   • Foundation concepts

2. Basic Family - Simple nuclear family

   • Core relationships
   • Minimal evidence requirements
   • Easy to understand

3. Complete Family ⭐ Recommended

   • All 9 entity types demonstrated
   • Complete evidence chains
   • Real-world family structure
   • Best practices shown

Advanced Concepts

4. Single-File - Single-file archives

   • All entities in one file
   • Portable format
   • Simple backup/sharing

5. Temporal Properties - Time-changing values

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

6. Participant Assertions - Event participants

   • Assertion-based participant roles
   • Conflicting evidence about participants
   • Evidence for relationships

Example Descriptions

Example	Focus	Entity Types	Use Case
Minimal	Essentials	Person	Smallest valid archive
Basic Family	Relationships	Person, Relationship	Nuclear family structure
Complete Family ⭐	All features	All 9 types	Comprehensive demonstration
Single-File	Portability	All in one file	Simple sharing/backup
Temporal Properties	Time-changing data	Person with temporal values	Changing occupations/names
Participant Assertions	Event participation	Assertion-based roles	Evidence-based participants

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