6 questions
0
votes
1
answer
290
views
Asciidoc define variable local to file
I'm using the arc42 template to create my documentation. It has a structure with a main file that includes files that contain the various chapters. I'd like to redefine a variable that is local to one ...
- 2,566
0
votes
1
answer
34
views
Integrate an Arc42 subdocu into main Arc42 docu
I have each services with its own arc42 docus and i want to bind each of them in a global arc42 in sub chapter. How can i achieve this. Is it possible to link defined chapter from external arch42( is ...
3
votes
1
answer
186
views
Should I document the current context and scope too
I am currently writing an arc42 specification document for an application that is supposed to replace several convoluted manual processes.
In the documentation as well as the examples I noticed, that ...
1
vote
1
answer
337
views
arc42 template: Target architecture vs status quo
A colleague and I were wondering the following today: the documentation that one maintains based on this template is a living thing, and thus all the sections will be corrected and extended as the ...
- 13
3
votes
1
answer
890
views
How to handle requirements in arc42
The first three chapters in arc42 are related to software requirements:
Introduction and Goals
Constraints
Context
Most projects start with a detailed specification (hopefully) already containing ...
- 11.1k
7
votes
2
answers
2k
views
Where to document database schema in arc42?
I want to document a software project using the arc42 template. Where can I document the database schema? Is it a building block, so it has to be part of chapter 5 (Building Block View)?
- 143