Skip to content

V0.2 draft#6

Draft
SethDocherty wants to merge 8 commits intomainfrom
v0.2-draft
Draft

V0.2 draft#6
SethDocherty wants to merge 8 commits intomainfrom
v0.2-draft

Conversation

@SethDocherty
Copy link
Member

No description provided.

johnx25bd and others added 5 commits November 2, 2025 22:14
Major changes:
- Rename fields to snake_case: lp_version, location_type, event_timestamp, media_data, media_type, recipe_type, recipe_payload
- Update srs field to require OGC HTTP URI format (http://www.opengis.net/def/crs/...)
- Add attributes and attributes_schema fields for structured metadata
- Change versioning to full semver (1.0.0)
- Update terminology: "attestation" -> "record" for generalization
- Add comprehensive README with clear WHY and differentiation from GeoJSON/STAC/KML/Overture

Updated files:
- README.md: New "Why Location Protocol?" section with comparison table
- data-model.md: All base field definitions updated with new names and constraints
- schemas.md: Complete JSON Schema with v0.2 field names
- composable-fields.md: Snake_case fields + new attributes extension
- core-concepts.md: Updated terminology and examples
- location-types.md: Updated field references

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
…ement

Major messaging fix:
- Emphasize LP wraps existing formats (GeoJSON, H3, WKT, etc.)
- NOT a 15th competing standard - it's a meta-standard/envelope
- Clear 'What Location Protocol Is NOT' section
- Focus on adding missing metadata layer (versioning, SRS, verifiability)
- Existing formats go INSIDE the location field

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
Corrected format from underscore/dot-separated to hyphen-separated:
- coordinate_decimal → coordinate-decimal
- geojson → geojson-point
- h3 → h3-index

All identifiers now follow <format>-<type>[+<additional-details>] pattern
Updated: data-model.md, schemas.md, location-types.md, core-concepts.md, composable-fields.md, README.md

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
This content was outdated and inconsistent with the main v0.2 spec:
- Used different field naming conventions (camelCase vs hyphen-separated)
- Had typos (recepient, prooverAddress, folder name itself)
- Duplicated EAS integration content now in docs/spec-page/appendices/
- Was tightly coupled to EAS vs the platform-agnostic main spec

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Links to specification/ files needed ../ prefix since workflow.md
is in implementation/ directory.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@netlify
Copy link

netlify bot commented Dec 19, 2025

Deploy Preview for protocol-spec-docs ready!

Name Link
🔨 Latest commit f2e0b2e
🔍 Latest deploy log https://app.netlify.com/projects/protocol-spec-docs/deploys/6945ece35383ba0008448ccb
😎 Deploy Preview https://deploy-preview-6--protocol-spec-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

…x references

This commit introduces a comprehensive new appendix on Spatial Reference Systems (SRS), URI/URN CRS identifiers, and coordinate order guidance in 'docs/spec-page/appendices/srs.md'. It updates the appendices index ('docs/spec-page/appendices/index.md'), the main documentation index ('docs/spec-page/index.md'), and the MkDocs navigation ('mkdocs.yaml') to add links to the new SRS documentation. This provides authoritative guidance for implementers and ensures the new appendix is properly integrated and discoverable within the documentation.
@SethDocherty
Copy link
Member Author

@johnx25bd, After doing a little bit of a deep dive today on the change for the srs field, and 💯 agree with using URI in lieu of short-hand codes. I ended up creating a new appendix resource page discussing spatial reference systems, since I know it's a bit of a gray area for many users.

When you get a chance, please review and let me know if there are any modifications and/or additions.

@SethDocherty
Copy link
Member Author

What's the reasoning for renaming the fields from camelCase to snake_case?

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