提示5-14:解释在哪里可以找到构建块的源代码!
#building-block #source-code #mapping
如果您将源代码映射到构建块并非微不足道,您的arc42文档应明确说明在哪里可以找到源代码。
- 如果您坚持使用提示5-15(与目录结构对齐的构建块),您只需记录或指定源代码存储库的根目录。进一步的详细信息将来自此根目录。
- 如果您的源代码在不同的存储库中管理(例如不同的git或subversion存储库),您应该在 level 1 构建块上添加这些存储库的链接。
- 如果您的源代码分布在多个目录上,您可以记录每个构建块2-3个最重要的源工件的位置。
NEVER: 永远不要陷入为任何白盒列出所有代码工件的陷阱,因为这些信息是如此不稳定……
译者:不要过度追求所谓的“清晰”,而把所有代码细节都贴到构建块上。因为代码细节是不断变化的,所以您最终会失去控制。