/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/README.md
Purpose: Master navigation guide and document overview
Key Sections:
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/QUICK_REFERENCE.md
Purpose: Fast lookup guide, one-page reference, checklists
Key Sections:
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/RESEARCH_SUMMARY.md
Purpose: Executive overview, strategic context, project planning
Key Sections:
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/research_software_metadata_standards.md
Purpose: Comprehensive standards reference, detailed field definitions
Key Sections:
1. CodeMeta (50+ properties)
- Core identification fields
- Authorship & attribution
- Versioning & temporal
- Technical specifications
- Repository & distribution
- Licensing & rights
- Application classification
- Relationships & references
- Content & metadata
- Person/Organization/Role properties
- CodeMeta-specific extensions
2. CITATION.cff (21 core fields)
- Required fields
- Core metadata fields
- Citation & references
- Licensing & legal
- Person/Entity object structures
- Valid fields summary
3. Software Heritage
- Data model & artifacts
- Intrinsic vs. extrinsic metadata
- Preservation model
- Artifact identification
- Indexed metadata storage
4. Schema.org SoftwareSourceCode & SoftwareApplication
- Properties (inherits from CodeMeta)
- Key distinctions between types
- Notable software-specific properties
5. Zenodo Software Metadata
- Deposit metadata fields
- GitHub integration
- DOI & persistent identifiers
- Format support
- Software-specific fields
6. Mapping Matrix (6x6 coverage table)
7. LinkML Design Guidance
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/codemeta_field_examples.md
Purpose: Technical implementation guide with real code examples
Key Sections:
1. CodeMeta JSON-LD Example (production-ready, 40+ fields)
- Real-world climate science software
- All object types demonstrated
- Proper nesting and cardinality
2. CITATION.cff Complete Example
- Full YAML structure
- Extended person objects
- Preferred citation format
- Multiple author examples
- References array
3. Field-by-Field Mapping Tables
- Essential properties
- Recommended properties
- Optional properties
- Implementation notes
4. Object Structure Definitions
- Person (minimal, standard, extended)
- ComputerLanguage
- SoftwareSourceCode (as dependency)
- ScholarlyArticle (as reference)
- Organization
- Review
5. Conversion Pathways
- CodeMeta ↔ CFF mapping
- Tool recommendations
- Conversion patterns
6. SPDX Licenses
7. Semantic Versioning
8. Test/CI Examples
9. Related Objects
10. Key Differences Table
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/linkml_software_schema_fields.md
Purpose: Implementation inventory and LinkML schema design guide
Key Sections:
1. Complete Field Inventory (127 fields)
- A. Identification & Naming (10)
- B. Versioning & Temporal (13)
- C. Authorship & Attribution (14)
- D. Technical Specifications (13)
- E. Repository & Distribution (8)
- F. Build, Testing & CI/CD (8)
- G. Licensing & Rights (5)
- H. Citations & References (10)
- I. Relationships & Hierarchies (9)
- J. Content & Documentation (6)
- K. Specialized (SWH/Provenance) (10)
- L. Zenodo-Specific (9)
Each field includes:
- Type and cardinality
- Required/optional status
- Description
- Source standards
- Examples
- Validation patterns
2. Object Structure Definitions (YAML-ready)
- Person with all contact fields
- Organization with ROR ID
- ComputerLanguage
- SoftwareSourceCode
- Citation structure
3. Recommended Field Selection by Use Case
- Minimal (11 fields)
- Standard (24 fields)
- Complete (47+ fields)
- Archive & Preservation (58+ fields)
4. LinkML Implementation Tips
- Enumeration patterns
- Reusable class definitions
- Inheritance hierarchy
- Slot organization
- Validation patterns
- Cross-standard mapping
5. Summary Statistics
6. Sources & References
| Need | Document | Section |
|---|---|---|
| One-minute checklist | QUICK_REFERENCE.md | One-Minute Checklist |
| Field → standard mapping | QUICK_REFERENCE.md | Quick Lookup |
| CodeMeta examples | codemeta_field_examples.md | Sections 1-7 |
| CFF examples | codemeta_field_examples.md | Section 2 |
| All 127 fields | linkml_software_schema_fields.md | Field Inventory |
| Use case recommendations | linkml_software_schema_fields.md | Recommended Selection |
| FAIR alignment | RESEARCH_SUMMARY.md | Critical Alignment |
| Conversion guide | codemeta_field_examples.md | Section 10 |
| Question | Answer In |
|---|---|
| What is CodeMeta? | QUICK_REFERENCE.md (table) or RESEARCH_SUMMARY.md (details) |
| What fields does CFF have? | research_software_metadata_standards.md (Section 2) |
| How do I convert CFF to CodeMeta? | codemeta_field_examples.md (Section 10) |
| What's the minimal metadata? | linkml_software_schema_fields.md (Recommended Selection) |
| How do I implement this in LinkML? | linkml_software_schema_fields.md (complete) |
| What's unique to Software Heritage? | research_software_metadata_standards.md (Section 3) |
| Where do I put CITATION.cff? | QUICK_REFERENCE.md (Where to Put Metadata) |
| What SPDX license should I use? | QUICK_REFERENCE.md (Common SPDX Licenses) |
| What does development status mean? | QUICK_REFERENCE.md (Development Status Values) |
| How do I validate my metadata? | linkml_software_schema_fields.md (Validation Patterns) |
| Document | Lines | Words | Fields Covered | Code Examples |
|---|---|---|---|---|
| README.md | 450 | 3,500 | Reference | Navigation |
| QUICK_REFERENCE.md | 400 | 3,000 | All 127 | Quick patterns |
| RESEARCH_SUMMARY.md | 200 | 2,500 | 127+ | Strategic |
| research_software_metadata_standards.md | 800 | 8,000 | All 5 standards | Detailed |
| codemeta_field_examples.md | 600 | 5,000 | 40+ | Production examples |
| linkml_software_schema_fields.md | 800 | 7,000 | All 127 | YAML patterns |
| TOTAL | 3,250 | 29,000 | Comprehensive | Extensive |
| Standard | Total References | CodeMeta | CFF | Schema.org | Zenodo | SWH |
|---|---|---|---|---|---|---|
| CodeMeta | 1,200+ lines | ✓✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓ |
| CFF | 400+ lines | ✓✓ | ✓✓✓ | ✓ | ✓✓ | - |
| Schema.org | 300+ lines | ✓✓ | ✓ | ✓✓✓ | ✓ | - |
| Zenodo | 400+ lines | ✓✓ | ✓✓ | ✓ | ✓✓✓ | - |
| SWH | 200+ lines | ✓ | - | - | - | ✓✓✓ |
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/README.md
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/QUICK_REFERENCE.md
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/RESEARCH_SUMMARY.md
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/research_software_metadata_standards.md
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/codemeta_field_examples.md
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/linkml_software_schema_fields.md
/home/mohammadi/Documents/Claude/Projects/Infrastructure and Tooling/INDEX.md (this file)
``
1. First Time? Start with README.md → QUICK_REFERENCE.md
2. Building Schema? README.md → linkml_software_schema_fields.md → codemeta_field_examples.md
3. Deep Dive? RESEARCH_SUMMARY.md → research_software_metadata_standards.md → All others
4. Quick Lookup? QUICK_REFERENCE.md or specific document sections
| Standard | Year Started | Current Status | Maturity |
|---|---|---|---|
| Schema.org (general) | 2011 | Active | Mature |
| Software Heritage | 2015 | Active | Mature |
| CodeMeta | 2016 | Active | Stable (v3.0) |
| CFF | 2017 | Active | Stable (v1.2) |
| Zenodo | 2013 | Active | Mature |
For questions about specific content:
1. Quick question? → QUICK_REFERENCE.md
2. Need details? → Specific document section
3. Building schema? → linkml_software_schema_fields.md
4. Still stuck? → README.md "How to Use These Documents" section
These documents reference and synthesize information from:
All reference URLs and sources are included in the source documents.