David Doria

非常好！ 正如你所提到的，定期编译示例当然至关重要。

我唯一的、这个技术无法满足的设计目标是让普通用户能够添加、更新或修复示例。 由于这些示例位于主存储库中，我假设只有“开发人员”（那些已获得提交访问权限的人）才能访问它们。 我想可以争辩说“只有开发人员，那些已经证明他们知道最佳实践的人等等，才应该编写示例。” 但是，根据我的经验，编写最多示例的人是“中间人” - 那些非常擅长使用该库，但不必对开发感兴趣，因此没有提交访问权限的人。 通过真正地“众包”示例，它将更多负担放在整个社区上，并让开发人员进行观察，而不必投入大量精力来编写示例。

我真的很高兴看到其他项目认真对待这一点，谢谢你的链接 Brad！

布拉德，

那是一个非常好的实践！ 快速 Google 搜索后，我没有找到 QCA 的示例 - 你能发布一个链接吗？

我们在 ITK 项目中也进行了相同的交叉链接（请参阅 http://www.itk.org/Doxygen/html/classitk_1_1AddImageFilter.html 示例）。 有一个“Wiki 示例”部分。 我们也从示例链接到 Doxygen：http://www.itk.org/Wiki/ITK/Examples#Trigonometric_Filters（ITK Classes Demonstrated 列）。

我们有一个完整的系统专门用于示例显示和编辑。 它比标准的 wiki 更适合这项工作。 敬请关注...！