源核心存储库和便签

Question

最近发生了一个有趣的问题，我一直在考虑实现这一目标的“最佳”方式（对于给定的“最佳”值）。

实质上，它是跟踪源代码的注释之一。 标记为此的示例在SLA中实时修复了问题，以及如何最好地实现此目的。 在没有详述所有细节的情况下，它找到了一个在许多地方使用的功能，可能有也可能没有错误，但问题是只在一个地方报告。

满足SLA的修复只是添加一个检查报告问题的位置，而不是调整公共代码并且必须测试触及该功能的所有内容。

然后有趣的问题是上游。 然后，“正确”的方法是返回并检查原始函数，验证它在所调用的任何地方是否正确，然后如果确定库函数错误则进行“正确”更改。

问题是这需要时间，所以上游可能只是采取解决方法等。但是如果问题再次发生（例如六个月后）在调用相同库函数的另一个位置，则没有一种简单的方法来链接这两个问题一起。 您可以搜索错误跟踪数据库，但这并不能保证提供帮助 - 这取决于是否添加了一个注释，说明“此库函数需要更彻底的检查，但现在没有时间进行调查”。

所以问题是：在一个庞大的开发团队中（30多个，分成支持和正在进行的开发的团队），你使用什么方法来管理（有效的）针对源代码的“粘滞便笺”，简短添加评论到可疑功能的源代码说“这可能有点狡猾”？

提交评论的问题是过程之一：变更是一种变化，因此提交零变化变更（即只添加评论的变更）并不理想; 开发人员甚至可以通过添加注释（点击一个流浪键或其他东西）来犯错误，因此只有在实际进行更改的地方才能提交（IMO）。

现在可以使用wiki来跟踪每个文件的注释，但是我们至少有四个分支并且没有几百个文件（SQL对象，源代码，XML文件等），所以wiki会变得无法解决很快。

如果SCM可以支持这种情况，那将是很好的事情 - 对于简单注释的文件，但不添加到SCM的版本历史记录中的元数据 - 可以在执行（比如说） svn update ，或手动查看。

可能已经存在解决方案 - 那么您如何管理这种类型的知识共享？

Answer 1

好吧，我们现在正在使用这种方法：在每个检入SVN的文件夹中，我们创建了一个.url快捷方式（这是我们正在开发的Windows）链接到我们开发维基上关于该文件夹的页面。 因此，我们可以自由更新Wiki信息，在结账/更新时，每个人都会获得一个链接，将他们带到该文件夹​​/模块的相应Wiki页面。

我们不长时间煽动它所以我们必须看到它长期有效 - 但它比我们以前更好（即，没有:-)）。