Transportation linear referencing concept

[Brad Richardson (brad-richardson)]

• Creates new linear referencing concept page to document usage and generation.

Description

This is intended to make it clearer to consumers of Overture data how to use the transportation theme.

Reference

1. N/A

Testing

N/A - updated docs

Checklist

Checklist of tasks commonly-associated with schema pull requests. Please review the relevant checklists and ensure you do all the tasks that are required for the change you made.

1. Add relevant examples.
2. Add relevant counterexamples.
3. Update any counterexamples that became obsolete. For example, if a counterexample uses property A but is not intended to test property A's validity, and you made a schema change that invalidates property A in that counterexample, fix the counterexample to align it with your schema change.
4. Update in-schema documentation using plain English written in complete sentences, if an update is required.
5. Update Docusaurus documentation, if an update is required.
6. Review change with Overture technical writer to ensure any advanced documentation needs will be taken care of, unless the change is trivial and would not affect the documentation.

Documentation website

Docs preview for this PR.

[Copilot]

Pull request overview

This PR adds comprehensive documentation for linear referencing in the transportation theme. Linear referencing is a key concept that allows properties to apply to specific portions of road segments without splitting the geometry, which promotes shape stability and reduces unnecessary versioning.

Changes:

• Created a new dedicated documentation page explaining linear referencing concepts, calculation methods, and best practices
• Added a link to the new linear referencing page from the transportation index

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
docs/schema/concepts/by-theme/transportation/linear-referencing.mdx	New comprehensive documentation covering linear referencing concepts, calculation methods using WGS84 geodetic distance, code examples in SQL and Python, and edge cases
docs/schema/concepts/by-theme/transportation/index.mdx	Updated the Linear referencing section header to link to the new dedicated page

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Adam Lastowka (Rachmanin0xFF)]

a few nits