- Short answer
-
Both scope/context (arc42 section 3) and building block view (arc42 section 5) provide adequate room for external interfaces.
- Longer answer
-
How and where you describe external interfaces depends on several factors:
- If your system provides external interfaces to external consumers and you and your team can decide about any details of these interfaces - then you have to care for their documentation.
- Do you need to provide external systems with information on how to use your interfaces? You could provide example code and other interface documentation, but need to make sure this information is easily accessible to the external stakeholders.
- Do you just provide data at your external interfaces, and no services? Then you might stick to just a documentation of data formats (and maybe semantics).
- In case you use interfaces provided by external systems, make sure their documentation is easily accessible by your development and maintenance teams. Include references in the arc42 context or building block view.
Prefer to learn arc42 hands-on?
Practical architecture training, most classes taught by Peter Hruschka and Gernot Starke — the people who created arc42 and maintain this FAQ (dates with other trainers say so) — and solid preparation for iSAQB certifications.
Next dates
- 24–26 Nov 2026 DE IMPROVE · Hamburg waitlistevolve and maintain systems · with Carola Lilienthal & Gernot Starke
- 1–4 Dec 2026 DE MSA · München waitlistperfect preparation for iSAQB CPSA-Foundation certification
- 23–25 Feb 2027 EN MSA · onlineperfect preparation for iSAQB CPSA-Foundation certification · with Wolfgang Reimesch
- 2–5 Mar 2027 DE MSA · Münchenperfect preparation for iSAQB CPSA-Foundation certification
- 9–11 Mar 2027 DE Req4Arc · Münchengetting your requirements right
- 13–15 Apr 2027 EN IMPROVE · onlineevolve and maintain systems · with Wolfgang Reimesch
- 2–3 Jun 2027 DE ADOC · Mannheimarchitecture documentation · with Dr. Gernot Starke
- 8–11 Jun 2027 DE MSA · Mannheimperfect preparation for iSAQB CPSA-Foundation certification
All courses and dates: trainings.arc42.org · as of 20 Oct 2026