#每天一个知识点#
samples与examples有什么区别
没有强制国标,是开源圈约定俗成(Goose / Rust / C++ 仓库通用)
examples
API最小用法、基础入门、单特性演示
- 偏向Hello World、单一接口、最简正确写法
- 代码短、注释少、直白,目标:看懂这个API怎么调用
- 适合新手入门、快速验证语法
- 例: examples/hello.goose 、单个函数调用demo
samples
贴近真实业务、场景化、多API组合的完整小工程
- 把多个特性组合起来,模拟实际开发场景
- 结构完整,带构建脚本、README,可直接fork改一改上线
- 用来参考工程结构、最佳实践、落地思路
- 例:bench程序、小型工具、多模块组合案例
一句话总结
examples = 单特性最简演示; samples = 贴近生产的场景样例工程。
补充(很多仓库混用)
不少小项目直接随便起名,只看名字不一定准;ROS、.NET、Rust官方仓库是严格区分这套规范的 。
例如,给你Goose仓库的目录建议
- /examples :hello、基础ADT、简单循环、单API调用
- /samples :bench套件、数据处理小工具、完整可落地小程序
samples与examples有什么区别
没有强制国标,是开源圈约定俗成(Goose / Rust / C++ 仓库通用)
examples
API最小用法、基础入门、单特性演示
- 偏向Hello World、单一接口、最简正确写法
- 代码短、注释少、直白,目标:看懂这个API怎么调用
- 适合新手入门、快速验证语法
- 例: examples/hello.goose 、单个函数调用demo
samples
贴近真实业务、场景化、多API组合的完整小工程
- 把多个特性组合起来,模拟实际开发场景
- 结构完整,带构建脚本、README,可直接fork改一改上线
- 用来参考工程结构、最佳实践、落地思路
- 例:bench程序、小型工具、多模块组合案例
一句话总结
examples = 单特性最简演示; samples = 贴近生产的场景样例工程。
补充(很多仓库混用)
不少小项目直接随便起名,只看名字不一定准;ROS、.NET、Rust官方仓库是严格区分这套规范的 。
例如,给你Goose仓库的目录建议
- /examples :hello、基础ADT、简单循环、单API调用
- /samples :bench套件、数据处理小工具、完整可落地小程序
展开
1
5