Skip to content

Conversation

@claude
Copy link

@claude claude bot commented Nov 18, 2025

Summary

Adds documentation to CLAUDE.md about proper SSSOM file formatting, specifically addressing the issue of empty commented lines.

Changes

  • Added new "SSSOM Mapping Files" section after "Syntax Checking"
  • Documents requirement to avoid empty commented lines (# alone) in SSSOM files
  • Explains that empty comment lines can cause parsing issues with SSSOM validation tools
  • Provides clear examples of incorrect vs correct formatting
  • Emphasizes that metadata comments should be consecutive with no blank lines

Rationale

This guideline ensures that future SSSOM mapping files created in this project follow best practices and avoid validation issues. Empty commented lines were identified as problematic during review of PR #70.

Related

hoganwr and others added 4 commits November 18, 2025 17:17
Added SSSOM mapping file that maps 138 VeNom cat breed terms to VBO identifiers.
Successfully mapped 64 breeds (46%) with exact matches, while 74 breeds (54%)
could not be matched to existing VBO terms.

The mapping file follows the SSSOM (Simple Standard for Sharing Ontology Mappings)
specification and includes:
- CURIE prefix definitions for VeNom, VBO, SKOS, and SEMAPV
- Mapping metadata including confidence scores and justification
- Clear indication of unmapped terms for future curation

This enables interoperability between VeNom veterinary nomenclature and the
Vertebrate Breed Ontology for cat breeds.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Added missing required SSSOM metadata fields to make the mapping file valid:
- mapping_set_id: Globally unique identifier for the mapping set
- license: CC BY 4.0 (matching VBO ontology license)

These properties are required by the SSSOM specification for MappingSet.

Co-authored-by: Nico Matentzoglu <matentzn@users.noreply.github.com>
- Added mapping_set_id for unique identification
- Added mapping_set_description
- Added license (CC-BY 4.0)
- Added mapping_date
- Added creator_id (ORCID)
- Added mapping_tool and version information

Co-authored-by: Nico Matentzoglu <matentzn@users.noreply.github.com>
- Document requirement to avoid empty commented lines in SSSOM files
- Explain that empty comment lines can cause parsing issues
- Provide clear examples of incorrect vs correct formatting
- Add new section after Syntax Checking section

Co-authored-by: Nico Matentzoglu <matentzn@users.noreply.github.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.

1 participant