docs: narrow roadmap scope away from native CAD plugins#67
Merged
chrislyonsKY merged 1 commit intomainfrom Apr 20, 2026
Merged
Conversation
The roadmap previously committed abovepy to shipping native plugins for Civil 3D, Carlson, and OpenRoads Designer / MicroStation, with LandXML surface export positioned as the shared feed into those plugins. We are not pursuing that CAD-plugin direction. This commit aligns the public roadmap, landing copy, and plugin README with that decision. Changes: - v2.2 section retitled from "CAD/Survey Export Formats" to "Export Formats". Drops the LandXML and contour-DXF bullets; keeps the generic LAS and GeoTIFF entries. - v2.3 section drops the Civil 3D plugin prototype and updates its theme to "Analysis APIs" only. - v3.0 section no longer enumerates Civil 3D / Carlson / OpenRoads plugins. It now reads as an open theme, with the one concrete commitment being the scheduled removal of `to_landxml()`. - Non-Goals gains an explicit entry stating native CAD-platform plugins are out of scope; generic file-format interop remains in scope. - Target Users table updates Surveyor and Civil Engineer primary-tool columns to reflect what abovepy actually supports today (Python, QGIS, ArcGIS Pro) rather than tools we do not integrate with. - Platform Support table drops the Civil 3D / Carlson / ORD rows. - Landing page no longer lists LandXML among promoted export formats. - QGIS plugin README marks `to_landxml()` as deprecated and scheduled for removal in v3.0. `to_landxml()` itself remains in v2.1.x unchanged. The deprecation warning lands in v2.2.0 and the function is removed in v3.0.0 per the standard deprecation window. No code, tests, or public API are modified in this commit.
Up to standards ✅🟢 Issues
|
|
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Decision
abovepy is stepping back from the commitment to ship native plugins for AutoCAD Civil 3D, Carlson, and Bentley OpenRoads Designer / MicroStation. The LandXML surface export that was positioned as the shared feed into those plugins is also being wound down on the standard deprecation schedule.
This PR aligns the public roadmap, landing copy, and plugin README with that decision. No code, tests, or public API change in this PR.
What changes in docs
to_landxml().docs/index.md) — LandXML dropped from the promoted export-formats list.to_landxml()marked deprecated, scheduled for removal in v3.0.Deprecation path for
to_landxml()The function shipped in v2.1.1 and is public API, so removal follows a normal deprecation window rather than a yank:
DeprecationWarningadded into_landxml()with removal target.to_landxml(), its tests, and thelandxml_export.pyexample are removed. Thescipydependency is re-evaluated at that time.Test plan
mkdocs buildrenders the updated roadmap and landing page without warnings.