MDS 社区参与指南如何为这个开源移动出行数据规范做出贡献【免费下载链接】mobility-data-specificationA data specification to enable right-of-way regulation, digital policy, geofencing, and two-way communication between mobility companies and public agencies worldwide for any regulated, shared, or agency vehicle.项目地址: https://gitcode.com/gh_mirrors/mo/mobility-data-specificationMDSMobility Data Specification是一个全球性的移动出行数据规范它为城市和移动出行服务提供商之间建立了标准化的通信和数据共享框架。作为开源移动出行数据规范MDS 的成功依赖于全球社区的积极参与和贡献。无论您是城市管理者、移动出行服务提供商、开发者还是普通用户都可以通过多种方式参与到这个重要的开源项目中共同推动移动出行行业的数字化转型。 为什么要参与 MDS 社区参与 MDS 社区不仅能够帮助您更好地理解和使用这个移动出行数据规范还能直接影响全球移动出行行业的未来发展。通过参与社区您可以获得早期访问权第一时间了解 MDS 的新功能和改进影响规范发展您的需求和建议可以直接影响 MDS 的设计方向建立专业网络与全球移动出行领域的专家和从业者建立联系提升技术能力学习最新的数据标准和 API 设计最佳实践推动行业进步共同创建更加开放、透明和高效的移动出行生态系统 MDS 社区参与的基本要求在开始参与 MDS 社区之前请先了解一些基本要求1. 遵守行为准则所有参与者都必须遵守 CODE_OF_CONDUCT.md 中规定的行为准则确保社区环境的友好和尊重。2. 了解贡献指南详细的贡献指南可以在 CONTRIBUTING.md 中找到虽然它指向了 Open Mobility Foundation 的主贡献指南。3. 熟悉项目结构MDS 项目包含多个核心模块数据规范文档general-information.md 包含通用的数据规范信息API 端点定义provider/README.md 定义了服务提供商 API地理数据规范geography/README.md 包含地理信息相关规范政策规范policy/README.md 定义政策相关数据格式模式定义modes/README.md 包含各种移动出行模式的状态机 如何开始参与 MDS 社区第一步加入社区讨论最简单的方式是加入 MDS 工作组的邮件列表订阅 wg-mds 邮件列表获取最新的更新、工作组详情和会议信息。第二步探索项目文档在开始贡献之前建议先阅读以下关键文档核心文档README.md - 项目概述和快速入门指南数据规范data-types.md - 数据类型定义和规范版本信息ReleaseNotes.md - 版本发布说明发布指南ReleaseGuidelines.md - 版本发布流程第三步设置本地开发环境要开始技术贡献您需要克隆仓库git clone https://gitcode.com/gh_mirrors/mo/mobility-data-specification cd mobility-data-specification探索项目结构agency/- 机构相关规范metrics/- 指标定义和计算方法schema/- 数据模式定义jurisdiction/- 司法管辖区定义 四种主要的贡献方式1. 提出问题与建议如果您在使用 MDS 时遇到问题或有改进建议可以通过以下方式参与创建讨论在项目讨论区发起新的讨论话题提交问题报告使用 .github/ISSUE_TEMPLATE/bug_report.md 模板报告问题提出功能请求使用 .github/ISSUE_TEMPLATE/feature-request---proposal.md 模板提出新功能建议2. 提交代码和文档改进如果您有技术能力可以通过以下方式直接贡献修复文档错误改进文档的清晰度和准确性完善示例文件在examples/目录中添加更多使用示例改进数据模式优化 schema/ 目录中的模式定义添加测试用例确保规范的稳定性和兼容性3. 参与工作组会议MDS 工作组的定期会议是了解项目进展和参与决策的重要途径参加 MDS 工作组会议了解最新的规范发展和讨论加入技术委员会参与技术决策和架构设计参与策略委员会影响项目的长期发展方向4. 成为机构或服务提供商如果您代表城市机构或移动出行服务提供商添加机构 ID通过提交 Issue 或 Pull Request 将您的机构添加到 agencies.csv添加提供商 ID将您的服务提供商信息添加到 providers.csv分享实施经验在社区中分享您的 MDS 实施经验和最佳实践 理解 MDS 的数据模型在贡献技术内容之前了解 MDS 的核心数据模型至关重要移动出行模式状态机MDS 定义了多种移动出行模式的状态机这些状态机帮助理解车辆的生命周期微移动状态机modes/micromobility-state-machine-diagram.svg汽车共享状态机modes/car-share-state-machine-diagram.svg乘客服务状态机modes/passenger-services-state-machine-diagram.svg配送机器人状态机modes/delivery-robots-state-machine-diagram.svg核心数据端点MDS 包含六个主要的 API 端点每个都有特定的用途Provider API- 服务提供商实现机构使用Agency API- 机构实现提供商使用Metrics API- 指标计算和分析Policy API- 政策管理和执行Geography API- 地理区域管理Jurisdiction API- 司法管辖区定义️ 技术贡献的具体步骤1. 创建 Pull Request当您准备好贡献代码或文档时创建分支基于最新的 main 分支创建新分支进行修改按照项目规范进行更改提交更改使用清晰的提交信息创建 PR使用 .github/pull_request_template.md 模板等待审查项目维护者会审查您的贡献2. 文档贡献指南所有文档使用 Markdown 格式遵循现有的文档结构和风格包含清晰的示例和说明确保链接和引用正确3. 代码贡献指南遵循项目的编码规范包含必要的测试用例更新相关的文档确保向后兼容性 全球社区参与机会成为 Open Mobility Foundation 成员作为 OMF 成员您可以获得更多的参与机会董事会成员参与基金会战略决策隐私、安全和透明委员会关注数据隐私和安全问题技术委员会参与技术标准制定策略委员会影响项目发展方向工作组指导委员会领导具体工作组的工作参与特定工作组目前 MDS 社区有两个主要工作组MDS 工作组专注于 MDS 规范的维护和发展路缘工作组专注于路缘数据规范Curb Data Specification 衡量您的贡献影响通过参与 MDS 社区您的贡献将直接影响全球标准超过 1,200 个城市和 76 个国家使用 MDS行业实践超过 200 家移动出行服务提供商实施 MDS数据透明度促进城市和提供商之间的开放数据共享政策执行支持数字政策的实施和验证 持续参与的最佳实践保持关注定期查看 GitHub 上的 Issues 和 Discussions参加工作组会议和社区活动关注项目的最新发布和更新分享经验在社区中分享您的实施经验撰写博客文章或案例研究在行业会议中介绍 MDS帮助他人回答社区中的问题审查其他人的贡献指导新参与者 开始您的 MDS 贡献之旅无论您是技术专家、城市管理者还是移动出行爱好者MDS 社区都欢迎您的参与。通过贡献您的知识和经验您不仅能够帮助改进这个重要的开源移动出行数据规范还能推动整个行业向更加开放、透明和高效的方向发展。记住每一个贡献都很重要——从修复一个错别字到提出一个新的功能建议都能让 MDS 变得更好。立即加入我们共同塑造移动出行的未来下一步行动订阅邮件列表获取最新信息探索项目文档了解规范细节选择一个您感兴趣的领域开始贡献加入社区讨论分享您的想法让我们一起建设更加智能、可持续和包容的移动出行生态系统 【免费下载链接】mobility-data-specificationA data specification to enable right-of-way regulation, digital policy, geofencing, and two-way communication between mobility companies and public agencies worldwide for any regulated, shared, or agency vehicle.项目地址: https://gitcode.com/gh_mirrors/mo/mobility-data-specification创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考