Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
titleSections
Section
titleDescription

Provide an overview over the information on this document. Readers may decide on this description if the document contains relevant information to them.

Section
titleSummary

Provide a summary of the documents structure and key points. This is an informative abstract typically of about 100 to 200 words.

Expand for detailed information from https://github

.

com/arc42Source: arc42 on GitHub

Section
titleBusiness Context

Identify all neighbouring systems and specify all logical/business data that is exchanged with the system under development. Add data formats and communication protocols with neighbouring systems and the general environment if these are not specified in detail with the relevant components.

More help to document quality goals in this overview is found on arc42 on GitHub

Expand
title
Tip Box
titleUsing projectdoc

A context is typically documented with a View document. You may transclude from this document any sections that suites the information needs of your stakeholders.

Section
titleTechnical Context

Specify the communication channels linking your system to neighbouring systems and the environment.

More help to document quality goals in this overview is found on arc42 on GitHub.

Tip Box
titleUsing projectdoc
A context is typically documented with a View document. You may transclude from this document any sections that suites the information needs of your stakeholders.
Section
titleExternal Interfaces

For many building blocks you can describe its interfaces directly in the black box template of the building block. For complex interfaces - and external interfaces are normally very complex – it is worth while to describe them in separate sections.

More help to document quality goals in this overview is found on arc42 on GitHub.

Tip Box
titleUsing projectdoc
Use the Interface doctype and either list or transclude them in detail.
Transclusion
documentDocument Sections
idsstandard-sections-bottom

...