documentation - 如何跟踪项目无关的怪癖

Question

这个问题的答案可能只是标准的错误跟踪软件，如 jira 或fogbugz，但我有点希望那里有人知道我所描述的更好的系统。

我最近的项目需要大量的设置才能进入我可以实际开始编码部分的位置。例如:

在我启动 SSH 之前，需要执行一系列复杂的公司内部命令。

确保任何进行外部调用的第三方类都设置了内部公司代理选项 - 同时还确保在生产环境中安装时不会设置这些设置

确保在尝试安装 pear 包之前设置了代理。

其他类似的事情，主要涉及内部 IT 安全并使其与模块和包一起使用。

就个人而言，这些事情都不是什么大不了的事，我已经给自己写了很多关于我所做的确切命令和补充的笔记，但它们目前在一个普通的文本文档中，很难记住确切的位置是什么我需要的很远。我们还有几名新员工即将开始工作，我宁愿给他们一个更轻松的时间来设置他们的编程环境。

就像我说的，它们并不完全是“编程怪癖”，而只是在认真开始编程之前不断的摆弄。关于为我自己和后代的理智记录这些事情的最佳方式有什么想法吗？

Answer 1

我们使用 wiki 来托管这样的说明。让每个人都知道一个可以访问信息的公共(public)位置并在步骤发生变化时保持最新状态变得容易。

如果有部分可以自动化，那是个好主意，但如果需要非标准设置，我们总是为开发环境设置创建一个页面，而有人必须重复。