德国SAP用户组（DSAG）提供了一个可读且免费的指南，大数据课程，名为"开发最佳实践指南-ABAP开发的有用提示"。该指南有英文和德文两种版本。

该指南提到arc42是记录和交流软件体系结构的模板。这是一个免费的模板，云服务器多少钱一年，基于作者peterhruschka和gernotstarke在软件开发领域的经验。顺便说一句：名字中的数字42是对《银河系漫游指南》中深思熟虑的答案的暗示。这个模板由12个主要章节组成，涵盖了各种主题。这些包括在软件开发过程中发挥作用的技术、功能、组织和定性主题。

我在一些项目中使用过模板，我该怎么说？我喜欢。如果需要文档，arc42提供了一个很好的解决方案。这里有一些关于我的经验的笔记给那些有兴趣的人（即使你不想使用它，你也可以使用它的一个想法作为你自己的文档模板）。

这里是一个基于我的经验的优点和缺点的快速概述。

积极：

免费提供不同的格式，如Word和AsciiDoc结构化的，因此易于理解的不断发展可以很容易地用子章节展开按要求填写（并非每章都必须填写）是通用的，云服务器好吗，因此不依赖于编程语言可以在开发项目的早期使用面向不同的受众提供英语和德语版本提供培训（含费用）提供参考书（含成本）

负面：

努力熟悉结构努力学习如何将其与适当的编程语言（ABAP）结合使用由于并非所有章节都必须填写，因此乍一看，该文件似乎没有多少信息对于微型项目来说太复杂了

顺便说一句，arc42不能解决以下任务。然而，根据我的经验，这些任务不是由任何文档模板来解决的，只能由相应的工作组织来解决。

使文档保持最新有足够的时间（预算）记录创建文档的动机使用易于理解的结构定义存储位置创建高质量的文档（取决于许多因素）改善文档处理人员之间的沟通文档和系统中的开发对象之间的链接确保快速可用

对于那些对使用arc42感兴趣的人，这里有一些您第一步的资料来源。

arc42网站结构概述常见问题arc42模板的帮助

这里有一些关于我的第一步的注释…有这么多要报告的，它将超出这个博客的范围

工具：对于简单和快速创建arc42文档，我推荐微软Word和Visio以及Greenshot（或任何其他屏幕抓取器）。但是，如果多人在不使用Microsoft Sharepoint的情况下处理同一文档，则Word文档可能很难协调。在这种情况下，用于汇流的arc42模板非常有趣。到目前为止，我还不能尝试这么多，但我认为值得一看。

出发点：在处理了上述来源之后，我开始使用一个基于ALV网格的"简单"应用程序，其中包括一些选择和数据准备方面的特殊内容，因此文档很有用。我只能建议首先选择一个小而简单的项目从arc42开始，并在帮助下使用文档模板。书中的问题和笔记提出了足够多的附加问题，你会忙上一段时间。好同事讨论问题在这一点上也很有帮助

课文内容：我试着用一个想法一次构思一个短句。总的来说，只有尽可能多的文本和尽可能少的。由于文档在不同的章节中针对不同的读者，因此会自动使用功能（流程）和技术术语。在前几章中，这是更多的过程导向，然后它成为技术。在我没有什么可描述的章节中，政务大数据，我已经通过一个注释指出：

视觉内容：正如设计内容通常的情况一样，一幅画抵得上千言万语。这就是为什么使用统一建模语言、屏幕截图和Microsoft Visio的图形可能会非常方便的原因。

目前，我通过arc42记录的每一个开发都学到了很多东西。例如，我的第一个基于ALV的应用程序文档中的"运行时视图"一章几乎没有相关性，因此没有内容。

另一方面，当通过Business Add-in ME\u PROCESS\u PO\u CUST文档记录复杂的客户增强时，在标准应用程序逻辑的整体上下文中清晰地显示模块之间的交互非常好。作为一名开发人员，这在调试过程中非常有用。

对我来说，大数据挖掘，很明显，只有通过不同的项目，你才能了解arc42文档的不同细节。

因此，如果有人有兴趣交流想法，并将自己的经验贡献给SAP社区发布的"ABAP arc42最佳实践指南"，请与我联系。

由于存在arc42降价模板，这对于GitHub上的开放源代码项目可能很有意思。通过这种方式，您可以更快地交流各自开源项目的体系结构，从而简化其他开发人员的入门工作。

最后，关于文档的一般性词汇。对我来说，应用程序的设计已经是一种文档形式了，使用高质量的注释和尽可能多的注释可以让其他开发人员更容易地在源代码丛林中找到自己的方法（请查看SAP代码风格指南）。有些开发对象乍一看就透露了很多

如果有疑问，没有文档或者你找不到现有的文档，那么你就依赖于开发对象，只能希望它们的目的是不言自明的

玩得开心，分享你的经验和想法