采用“程序员”笔记的有效方法是什么？ [关闭]

Question

我经常多次遇到有人向我询问我工作过的错误或功能的问题。 通常通过查看Bugzila以及我的CVS报告，我花了很长时间才回想起它。 所以我试图找到一个很好的方法来记录我一直在做的事情，并寻找你的建议。 事实上，我通常会记录关于我所做的事情的几乎ZERO注释，尽管我在获取规范或某些技术内容时会写笔记。

我听说有些人为他们正在处理的每个问题或bug创建一个新文档，并附加配置信息，日志输出，我的思考和事情。 我认为这对每周/每月报告很有用，并且有助于记住你曾经做过的事情或者你修复过的类似错误。

请建议您如何记笔记？

Answer 1

共识似乎是博客或实体笔记本是要走的路。 除此之外，你可以使用维基或像OneNote这样的应用程序。

请看这个问题： https ： //stackoverflow.com/questions/78756/what-do-you-use-to-keep-notes-as-a-developer

Answer 2

桌子+绘儿乐

Answer 3

一个良好的源代码控制系统具有良好的代码注释和良好的签入评论策略可以创造奇迹。

Answer 4

• 有一个博客，即使没有人读它。 写一篇文章/ howto / what-I-did，你知道你可能想要记住几个月或几年后的事情。 谁知道，其他人也可能觉得它很有用。
• 使用Trac或Github为每个项目提供一个不错的wiki。 除了提交消息之外，您还可以在Wiki中保留特定于项目的注释和方法。 OBV。 这有助于文档和团队的其他成员
• 对于短期笔记，请随身携带笔记本和铅笔。 但如果你像我一样，你不久就会失去或错放这些东西
• 在每个项目中保留一个TODO和CHANGELOG文件。 有时很难维护，但是我曾经多次保存过###
• 如果真的很重要的话，就像Memento中的那个人一样在你的手臂上纹身。

我有一个非常糟糕的记忆，并且不希望在2周后记住任何事情（通常我会这样做，但当时你无法预测你是否会记住某件事）。 所以这些是我的改编和工作得很好。

Answer 5

人们已经提出了许多如何实际记录笔记的方法，但我认为这种方法是最重要的。

在我的工作中，我们为许多不同的公司开发定制软件，并且在每个支付期结束时，我们会向他们发送一份时间表，他们必须签署这些时间表，以便我们为他们开账单。 恰好这个时间表概述了开发人员所做的所有工作，通常结构就是这样的。

时钟 - 上午8:00

分析 - 上午10:30
完成分析工作的描述。

编码 - 下午12:30
所有编码工作的描述。

我们的想法是向客户证明，当您对其进行计费时，您不会整天都在StackOverflow上。 因此，您可以记录您执行的所有编码，调试等操作。

虽然我是第一个承认这个过程很痛苦的人，但我无法计算我回去查看过去的时间表的次数，看看我是如何解决我遇到的问题，或者弄清楚我在一段时间内没有触及的项目。 这很棒。

Answer 6

博客吧。 或者为开发人员注释设置内部Wiki。

Answer 7

你想要简单，所以你可以很快进入。 我使用一个文本文件并将其添加到桌面上，并保留一个标准名称，如NOTES，NOTES2类型的README或TODO格式，每当您添加新条目时都会有日期。

只要它很简单，一切都会奏效。 如果你开始添加服务器和wiki以及所有这些东西，那么你已经过度复杂了你想要的东西。

Answer 8

我是一个实用的极简主义者。

Notepad ++每天都在我的右侧显示器上打开。 我按照我认为合适的方式添加它，但是当我提交更改时，我总是将注释放入subversion中。 事情变化很快。

我曾经常常使用tiddlywiki，但Notepad ++对我来说效果更好，并且被剥离到我需要的东西 - 一个我可以稍后搜索的地方。 我不喜欢物理笔记本的东西是我在一个人寻找东西时必须成为搜索引擎。

我就是这样做的。

Answer 9

我发现TiddlyWiki非常方便。 这是一个独立的维基，我用它来记录各种各样的事情 - 从我的个人待办事项到关于特定功能实现的注释。 将它与Dropbox结合使用，它会显示在我的所有系统上。

Answer 10

安装桌面搜索引擎。 索引文本文件备注，电子邮件和IM日志。

此外，我有时会在错误/功能请求票证中添加注释，并附上技术说明 - 清楚地标明这样，以免混淆非技术观众。

Answer 11

另一种记笔记的方法是使用思维导图。 它需要一点点才能掌握它，但我发现这些在组织我对各种主题的思考方面具有极大的价值，包括编程任务。 我甚至修补了一个工具，将我的思维导图直接转换为可粘贴到Jira评论中的嵌套列表:)使代码读取笔记和设计/估计笔记非常容易构建和更改。

一些适用于思维导图的工具：

• XMind的
• vym （查看你的想法）

Answer 12

除了bug追踪器或计算机化的笔记之外，我总是有一本日志，我将用它来记录每一天的某些重要形式。 通过这种方式，我可以轻松地回过头来查找特定日期并查看我在那里写下的内容。

Paper + Pen仍然是一个很棒的工具。

Answer 13

我一直在使用Moleskine笔记本很长一段时间，每当我转移到其他东西时（我使用过OneNote，WikidPad，Tomboy等）我总是回到我的笔记本上

Moleskine有各种尺寸，更不用说至少3种类型的纸张：普通，格子，网格

http://www.moleskines.com/moleskine-softcover-xlarge-squared.html

希望这可以帮助

Answer 14

我用cat >> ~/TODO ，博客或写下笔记本（物理）。

Answer 15

根据您的环境，您可以在// TODO的行中创建自定义标签：此外，您应该将源控制系统设置为拒绝不带注释的签入。

随着时间的推移记录某些东西的绝对最佳方式，让你知道你做了什么，下一个人知道如何维护它，是针对你所有变化的单元测试。 切换到单元测试的源的带注释的视图，您有日期和时间。

我也喜欢一个注释，它可以毫不费力地拖放任何格式，你不用担心打开，保存，任何东西，只是让它运行，它会处理细节。

Answer 16

我自己的系统是：

• 索引卡可以立即记下我需要记住或引用的东西。 （几乎所有这些都会在一天结束时被扔掉。）
• OmniOutliner用于个人笔记
• 用于待办事项列表的OmniFocus
• 错误跟踪系统评论有关跟踪和修复错误的信息
• 维基信息与团队共享信息
• 博客可能是各地程序员普遍感兴趣的东西

通常，事情从OmniOutliner开始，然后根据需要复制并粘贴到其他系统。

我的Macbook的Spotlight搜索很擅长查找内容，所以我不太担心组织问题。

Answer 17

我从这个网站找到了TodoList： http ：//www.abstractspoon.com/它易于使用，不需要安装，而且功能很好。

为了处理更多的笔记，我建议使用WikiPad ，它可以让您构建信息。

Answer 18

• 有关特定问题调查的注释的错误跟踪器。 这可以包括测试代码，日志输出，如何缩小范围的更新以及您已排除的内容。 我试着假设我将被一辆公共汽车碾过，其他人明天将接管这个漏洞。 他们将拥有错误跟踪器注释，我当前工作目录中的任何代码都可以在我的电脑上使用，并且可以假设它不能读取我的笔迹。 他们希望最迟在上午10点到达我所在的地方。 它应该包括对导致该错误的问题的完整描述，以及它如何被修复，用于历史记录。 当有人问“那个错误修正是什么时，你会去做什么？”。 如果有人说“我在其他地方看到了类似的问题，我应该检查什么？”，正在进行的细节是你所指的。
• 使用错误跟踪器，请求跟踪器，设计文档或任何您拥有的新功能和更改也是如此。
• 代码中的注释，用于解释实现原因的注释。
• 文档中的注释，用于解释界面原因的说明（“基本原理”）。

我不喜欢仅为我保留关于我的代码的个人注释，即使是在理论上公开的Wiki或博客上也是如此。 除非（1）你有一个非常好的内部搜索设备，并且（2）每个人都在大量写博客，以至于其他人希望有一些值得寻找的东西，否则没有人会在他们需要的时候找到它们。 如果注释与代码有关，那么它们应该在代码或其文档中，或者至少在bug跟踪器中（这解释了前面代码的错误，而注释解释了当前版本的正确性） 。

注意，“我需要做什么才能安装和运行IDE”，当然，他们会进入维基或博客。 公共的东西，或者你的同事可以看到和搜索的东西，但是因为你是最有可能想要它的人而特定于你。

如果您正在开发源代码，那么博客可能是更好的选择，因为世界上任何人都可能想知道它，并且可能会在整个网络上搜索信息。 但我从未参与过一个重要的开源项目。

Answer 19

我是Nick Cernis'Todoodlist的粉丝 。

Answer 20

虽然这不是技术性的，但我已成为时髦PDA的忠实粉丝。

（简而言之：一堆3x5卡片和一个活页夹。它实际上非常有用。）

Answer 21

我喜欢jira它的设计非常好，但不是免费的

http://www.atlassian.com/software/jira