API一致性与文档更新

随着OpenHarmony版本的迭代，GPIO相关的API是否保持了良好的向后兼容性？对于已弃用或即将变更的API，官方如何及时通知开发者并提供迁移指南？现有的GPIO驱动开发文档是否涵盖了所有最新的特性和最佳实践？如果开发者发现文档与实际代码存在出入，应通过何种渠道反馈以促进文档的及时更新？

好问题！
我从轻量系统角度回答。


随着OpenHarmony版本的迭代，GPIO相关的API是否保持了良好的向后兼容性？
-- 在OH 1.0时期，IoT接口是完善的。但是从1.0.1开始，到现在，IoT接口是残缺的。例如，IoSetFunc()函数；再比如，ADC相关API。但是从1.0.1到现在，IoT接口基本没变。可以认为“保持了良好的兼容性”。


对于已弃用或即将变更的API，官方如何及时通知开发者并提供迁移指南？
-- 目前并没有主动推送功能，把变更及时推送到开发者。官方迁移指南目前我没有看到，但是我总结了从1.X到4.0的适配指南。


现有的GPIO驱动开发文档是否涵盖了所有最新的特性和**实践？
-- 官网文档基本涵盖最新特性。**实践参考：https://growing.openharmony.cn/mainPlay/learnPath/?developmentRole=1

如果开发者发现文档与实际代码存在出入，应通过何种渠道反馈以促进文档的及时更新？
-- 这种情况很常见。可以提交issue。