VI - docToolchain | arc42 by Example

Sign In Start Free Trial

Book Overview & Buying
Table Of Contents

arc42 by Example

By : Gernot Starke, Michael Simons, Stefan Zörner, Ralf D. Müller

arc42 by Example

By: Gernot Starke, Michael Simons, Stefan Zörner, Ralf D. Müller

Overview of this book

When developers document the architecture of their systems, they often invent their own specific ways of articulating structures, designs, concepts, and decisions. What they need is a template that enables simple and efficient software architecture documentation. arc42 by Example shows how it's done through several real-world examples. Each example in the book, whether it is a chess engine, a huge CRM system, or a cool web system, starts with a brief description of the problem domain and the quality requirements. Then, you'll discover the system context with all the external interfaces. You'll dive into an overview of the solution strategy to implement the building blocks and runtime scenarios. The later chapters also explain various cross-cutting concerns and how they affect other aspects of a program.

About the Book

About the Book

About the Authors

Learning Objectives

Audience

Approach

Conventions

Free Chapter

Acknowledgements

Acknowledgements

I - Introduction

I - Introduction

I.1 What is arc42?

I.2 Why This Book?

I.3 What This Book is Not

I.4 An Overview of Examples

I.5 A table of arc42 Topics

II - HTML Sanity Checking

II - HTML Sanity Checking

II.1 Introduction and Goals

II.2 Constraints

II.3 Context

II.4 Solution Strategy

II.5 Building Block View

II.6 Runtime View

II.7 Deployment View

II.8 Crosscutting Concepts

II.9 Design Decisions

II.10 Quality Scenarios

II.11 Risks and Technical Debt

II.12 Glossary

III - Mass Market Customer Relationship Management

III - Mass Market Customer Relationship Management

III.1 Introduction and Requirements

III.2 Constraints

III.3 Context

III.4 Solution Strategy

III.5 Building Blocks

III.6 Runtime View

III.7 Deployment View

III.8 Cross cutting Concepts

III.9 Architecture Decisions

III.10 Quality Scenarios

III.11 Risks

III.12 Glossary

IV - biking2

IV - biking2

IV.1 Introduction and Requirements

IV.2 Architecture Constraints

IV.3 System Scope and Context

IV.4 Solution Strategy

IV.5 Building Blocks-Level 1

IV.6 Runtime View

IV.7 Deployment View

IV.8 Technical and Crosscutting Concepts

IV.9 Architecture Decisions

IV.10 Quality Scenarios

IV.11 Risks

IV.12 Glossary

V - DokChess

V - DokChess

V.1 Introduction and Requirements

V.2 Constraints

V.3 Context

V.4 Solution Strategy

V.5 Building Block View

V.6 Runtime View

V.7 Deployment View

V.8 Technical and Cross cutting Concepts

V.9 Design Decisions

V.10 Quality Scenarios

V.11 Risks

V.12 Glossary

VI - docToolchain

VI - docToolchain

VI.1 Introduction and Goals

VI.2 Architecture Constraints

VI.3 System Scope and Context

VI.4 Solution Strategy

VI.5 Building Block View

VI.6 Runtime View

VI.7 Deployment View

VI.8 Cross cutting Concepts

VI.9 Design Decisions

VI.10 Quality Requirements

VI.11 Risks and Technical Debts

VI.12 Glossary

VII - macOS Menu Bar Application

VII - macOS Menu Bar Application

VI.4 Solution Strategy

This chapter describes the strategy we used to approach problems in the past and how we will approach them in the future.

General Solution Strategy

The first docToolchain tasks evolved from standalone scripts that were executed from the command line. The next logical step was to include them in a build system.

In Gradle, it is relatively straightforward to be able to include a Groovy-based script as a new task:

task newTask (

description: 'just a demo',

group: 'docToolchain'

) {

doLast {

// here you can put any Groovy script

}

}

The original build.gradle soon grew into a huge single file. To make it more modular, we split it up into so-called script-plugins (https://docs.gradle.org/current/userguide/plugins.html#sec:script_plugins). You extract tasks that belong together in an extra .gradle file (for...

CONTINUE READING

83

Tech Concepts

36

Programming languages

73

Tech Tools

Unlimited access to the largest independent learning library in tech of over 8,000 expert-authored tech books and videos.

Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.

50+ new titles added per month and exclusive early access to books as they are being written.

arc42 by Example

Search

Your notes and bookmarks