Skip to content

docs: add comprehensive supported file formats page#608

Open
wyatt-leaf wants to merge 13 commits intomasterfrom
add-shapefile-requirements
Open

docs: add comprehensive supported file formats page#608
wyatt-leaf wants to merge 13 commits intomasterfrom
add-shapefile-requirements

Conversation

@wyatt-leaf
Copy link
Contributor

@wyatt-leaf wyatt-leaf commented Dec 11, 2025

Summary

  • Creates a new Supported File Formats page that consolidates all provider file format documentation
  • Moves file format details from converters_endpoints.md to the new dedicated page
  • Makes file format requirements easily accessible from the Manual File Upload sidebar section
  • Links to existing Units and Sample Responses docs for output property details (avoiding redundancy)

Changes

  • New: docs/supported_file_formats.md - comprehensive page with:
    • Overview table of all supported formats
    • Sections per provider with file format tables and expected ZIP structures
    • Shapefile section with structure requirements and unit handling notes
  • Modified: docs/converters_endpoints.md - removed inline file format details, replaced with link to new page
  • Modified: sidebars.js - added new page to Manual File Upload category

Test plan

  • Verify new page renders correctly
  • Verify links from converters_endpoints.md work
  • Verify sidebar navigation works

🤖 Generated with Claude Code

wyatt-leaf and others added 2 commits December 11, 2025 14:03
Add new documentation page detailing shapefile upload requirements including:
- File structure requirements
- Supported operation types (harvested, planted, applied, tillage)
- Attribute specifications for each operation type
- Geometry and unit handling information

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The node runtime should not be listed as an npm dependency.
If a Node.js version requirement is needed, use the engines field instead.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@wyatt-leaf wyatt-leaf requested a review from awimbush December 11, 2025 20:08
wyatt-leaf and others added 2 commits December 11, 2025 15:41
- Create new supported_file_formats.md with all provider file formats and structures
- Move file format details from converters_endpoints.md to new dedicated page
- Update sidebar to include new page under Manual File Upload
- Link to existing Units and Sample Responses docs for output properties

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@wyatt-leaf wyatt-leaf changed the title Add shapefile requirements documentation docs: add comprehensive supported file formats page Dec 11, 2025
wyatt-leaf and others added 9 commits December 12, 2025 08:56
The Details column contained file path info that duplicates the
Expected file structure sections below each table.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add Details column to individual provider tables showing operation types
  and file extensions (e.g., "Harvest, planting, and applied data in .jdl files")
- Combine GreenStar 2 and GreenStar 3 into single table row (both use GS3 format)
- Reorder file structure examples chronologically (GS2 → GS3 → Gen4)

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add table showing required attributes for each operation type
(harvested, planted, applied, tillage) based on standard_geojson_definition.json

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
… mappings table

- Split combined ISOXML section into separate sections for each provider:
  CLAAS, Kuhn, Kverneland Group, Müller-Elektronik, Teknomika, Topcon
- Replace "Required attributes by operation type" table with comprehensive
  "Supported Property Naming Conventions" table from property_map.json
- Escape underscores in column names to prevent markdown formatting issues

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Keep only properties marked as required in standard_geojson_definition.json
- Filter input column names to DBF-plausible values (≤10 chars)
- Remove provider-specific prefixes (CNHV2*, vr*, dt*, VRY*)

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Reorganize the property mappings table into sections for each operation
type (Harvested, Planted, Applied, Tillage) to match the structure in
standard_geojson_definition.json.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Extract common properties (timestamp, distance, elevation, operationType)
  into "All Operations" table
- Add tabbed interface for operation-specific properties
- Reduces repetition and matches style of other docs

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Remove common properties section (timestamp, distance, elevation, operationType)
- Remove tillage operation type
- Remove non-required properties from operation-specific sections
- Add note about contacting support for additional column names
Changed /docs/page-name format to just page-name for internal links.
The /docs/ prefix doesn't work locally due to baseUrl config.
Copy link
Contributor Author

@wyatt-leaf wyatt-leaf left a comment

Choose a reason for hiding this comment

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

looks good

@awimbush awimbush closed this Dec 15, 2025
@awimbush awimbush reopened this Dec 15, 2025
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.

3 participants