Skip to content

Fix grammar, consistency, and formatting in Geospatial.md#575

Merged
alamb merged 1 commit into
apache:masterfrom
iemejia:fix/geospatial-docs
Jun 3, 2026
Merged

Fix grammar, consistency, and formatting in Geospatial.md#575
alamb merged 1 commit into
apache:masterfrom
iemejia:fix/geospatial-docs

Conversation

@iemejia

@iemejia iemejia commented Jun 2, 2026

Copy link
Copy Markdown
Member

Summary

Fix grammar, cross-document consistency, and formatting issues in the Geospatial logical type documentation.

Changes

  • Use uppercase algorithm names (SPHERICAL, VINCENTY, THOMAS, ANDOYER, KARNEY) to match parquet.thrift enum and LogicalTypes.md
  • Fix "edges interpolation" -> "edge interpolation" (2 occurrences)
  • Hyphenate compound adjective: "well known" -> "well-known"
  • Fix comma splice between independent clauses
  • Normalize "Y Values" -> "Y values" (mid-sentence consistency)
  • Add missing article for grammaticality
  • Fix markdown heading formatting for Coordinate Axis Order section
  • Fix missing space before parenthesis
  • Fix XYZM table column alignment
  • Make srid: prefix consistent (lowercase)

Validation

No semantic/behavioral changes to the format specification. All fixes are documentation-only.

Split from #572 for easier review.

- Use uppercase algorithm names (SPHERICAL, VINCENTY, THOMAS, ANDOYER,
  KARNEY) to match parquet.thrift enum and LogicalTypes.md
- Fix "edges interpolation" -> "edge interpolation" (2 occurrences)
- Hyphenate compound adjective: "well known" -> "well-known"
- Fix comma splice between independent clauses
- Normalize "Y Values" -> "Y values" (mid-sentence consistency)
- Add missing article for grammaticality
- Fix markdown heading formatting for Coordinate Axis Order section
- Fix missing space before parenthesis
- Fix XYZM table column alignment
- Make srid: prefix consistent (lowercase)

@alamb alamb left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me -- thank you @iemejia

@paleolimbot or @jiayuasu do you have a few moments to review this PR to ensure technical accuracy. I don't think it changes the spec meaning at all, but I would like a double check to be sure

@jiayuasu jiayuasu left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@paleolimbot paleolimbot left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the ping and the edits!

@alamb

alamb commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Thanks @paleolimbot and @jiayuasu and @iemejia !

@alamb alamb merged commit bc876b0 into apache:master Jun 3, 2026
4 checks passed
@iemejia iemejia deleted the fix/geospatial-docs branch June 8, 2026 17:21
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.

4 participants