代码之家  ›  专栏  ›  技术社区  ›  Pierre-Alain Vigeant

如何管理和记录闪存会议?

  •  4
  • Pierre-Alain Vigeant  · 技术社区  · 15 年前

    我称之为闪电会议,但也许还有另一个更合适的名字。

    偶尔(有时更频繁)我的一个开发人员来到我的办公桌,问他应该如何编写一段特定的代码。

    代码本身并没有直接回答某个特性,这意味着它在需求期间没有被设计,但它是特性内部行为的一部分。

    在讨论了5分钟后,我们决定解决问题。我的问题是,我应该如何记录这种讨论,以便将来当其他人看到这段代码时,他能够理解为什么它是以这种方式而不是以那种方式开发的?

    我应该让开发人员直接在代码中写下讨论的摘要,还是应该打开一个Word模板,像开两个小时的会议一样写下讨论?有什么建议吗?

    3 回复  |  直到 13 年前
        1
  •  3
  •   Michael Dillon    15 年前

    这就是拥有一个开发wiki的真正回报。您可以为Flash会议创建一个wiki页面,并将其链接到相关的其他页面。写下讨论的内容,然后让其他程序员检查它,并在他们认为合适的时候进行更新。有一个地方可以记录所有东西,您可以将它链接到您需要的任何其他地方,例如SVN URL到代码分支或链接到其他相关人员的其他wiki页面,代码库正在处理中。稍后,如果您需要查找,还可以搜索放在wiki页面中的关键字,以便以后查找。

        2
  •  0
  •   Oren Mazor    15 年前

    我会用代码来做,只要它不是一篇文章。一段简短的话,你就完了。

    没有什么比看一段代码然后去某个共享区寻找解释它的Word文档更让我烦恼的了。

    只要它是一个小特征相关的讨论。最有可能的是,大型设计应该进入到自己的元文档中。

        3
  •  0
  •   JeffH    15 年前

    历史信息可以进入版本控制签入注释

    在这些信息中,可以简单地捕获,然后一个选项是开发人员在将文件签入版本控制时在注释中描述讨论。如果您不信任开发人员在源代码管理中查找问题,请在签入前在源代码的注释中添加“请参阅mm/dd/yy上此文件的签入注释”。