Note Box referencing common Document Properties

In order to not duplicate the information about common properties provided by all doctypes, this box allows to reference the topic that provides this information.

Type

Description

The following placeholders are provided to configure the output:

NameDescription
doctype-nameThe name of the document type (doctype) that is documented. Provided this box as a reference to common document properties that are supported by theis document type by default.

Box

The document type ${doctype-name} provides the following properties:

Transcluded By

Name Short Description Doctype
The first chapter of the arc42 Template with information on requirements, quality goals, and stakeholders.
doctype
The second chapter of the arc42 Template with information on constraints and conventions.
doctype
The third chapter of the arc42 Template with information on context and external interfaces.
doctype
The fourth chapter of the arc42 Template explains the solution idea.
doctype
The fifth chapter of the arc42 Template with information on the local building blocks, and their dependencies and relationships.
doctype
The sixth chapter of the arc42 Template with runtime information about the architecture.
doctype
The seventh chapter of the arc42 Template with information about how the system is deployed.
doctype
The eighth chapter of the arc42 Template with conceptional information about the system.
doctype
The ninth chapter of the arc42 Template that explains the architecture decisions that led to the system.
doctype
The tenth chapter of the arc42 Template that lists scenarios to systematically evaluate the architecture against the quality requirements.
doctype
The eleventh chapter of the arc42 Template lists risks and technical debt.
doctype
The last chapter of the arc42 Template lists terms of the domain and explains them.
doctype
Credentials for development systems where the password is known to all who have access to the Confluence wiki.
doctype

Type-specific category for access information.

doctype
This documents a possible option for a decision. Choose this document type to describe the alternative for a decision in more detail. This is typically a subpage of a decision document.
doctype
Group your alternatives by a self-defined type.
doctype
Announcements are a way to communicate an important piece of information with your team.
doctype

Describe your vision for one year. You plan will help you stay focussed to accomplish your goals.

doctype

Categories for annual visions.

doctype
Document your app for your users and customers.
doctype
Provide more detailed information about a component of a tool.
doctype

Document the purpose and usage of the components of this type.

doctype
Document your extension for your users and customers.
doctype

Document the purpose and usage of the extension of this type.

doctype
Applications provided functions required by services. Applications may be hosted on one or more systems.
doctype

Type-specific category for applications.

doctype
Document the purpose and usage of the macro.
doctype

Document the purpose and usage of the macros of this type.

doctype

A parameter is a configuration option. Parameter exist on different layers. Wizard and macro parameters are configuration options. Use
parameter types to organize them!

doctype

Document the purpose and usage of the app parameters of this type.

doctype
Document a platform for apps.
doctype

Document the purpose and usage of the platforms of this type.

doctype
Document a service provided by an app.
doctype

Document the purpose and usage of the app services of this type.

doctype
Document a tool provided by an app.
doctype

Document the purpose and usage of the app tools of this type.

doctype

Document the purpose and usage of the apps of this type.

doctype
The blueprint of the arc42 Template creates a tree of pages in the Confluence space.
doctype
Document a possible option for an architecture decision. Choose this document type to describe the alternative for a decision in more detail. This is typically a subpage of an architecture decision document.
doctype
Group architecture alternatives by their type.
doctype
Document an aspect of your architecture. Something orthogonal or cross-functional like logging, exception handling or configurability.
doctype
Group architecture aspects by their type.
doctype
Document a architecture decision for an option. This is useful to state the reasons and the options that have been evaluated. Later other team members will have it easier to understand the decision.
doctype
Architecture decisions are group by their types. A commonly used decision type is 'Architecture'.
doctype
Document requirements you impose on artifacts. Artifacts are created by processes defined and used by the team. This includes assemblies created by the build process, source code artifacts or reports.
doctype
Artifact types categorize artifacts.
doctype
Explain an asset of your work. Add this document to a day in your diary.
doctype

Categories for assets.

doctype
Associates two documents.
doctype
Categorize associations by a type.
doctype
Document assumptions to assess risks and opportunities for the project.
doctype
Assumptions are grouped by their type.
doctype
Describe as a Blackbox the elements of a view where only the externally visible properties are relevant.
doctype
Group blackboxes by their type.
doctype
The blank template simply provides a minimal integration with projectdoc features. It is a quick starting point to use projectdoc.
doctype
Categories allow to set document instance of different doctypes in a hierarchy.
doctype
Categorize categories by a type.
doctype
Document a single change to configuration items or assets.
doctype

Add an severity to classify changes.

doctype

Add a status to categorize changes.

doctype

Add a theme to group changes.

doctype

Type-specific category for changes.

doctype
Describes an information need and use this description as a basis to create and maintain a document.
doctype
Categorize charters by a type.
doctype

A brief solution to a problem.

doctype

Categories for cheats.

doctype
Checklists allow to run manual tasks in a defined manner. It guides the user of the checklist through a process and helping to not forget a step.
doctype
Categorize checklists by type.
doctype
Describe the codes that are part of the product's API.
doctype
Code types categorize codes, used in logging or exception handling.
doctype
Components are part of a view on a system. A component may refer to a enclosed element or to a complete system of its own.
doctype
Component types categorize components.
doctype
Configuration items (CIs) may be (sub-)systems or components. Whatever may change and needs to be tracked may be documented as a CI.
doctype

Signals the status of an IT system, application, or a configuration item.

doctype

Type-specific category for configuration items.

doctype

Add cycles to group cycle phases.

doctype

Cycle phases define phases that are bound to a cycle, such as lifecycles or iterations.

doctype

Datasets are used as the input and output of processes.

doctype

Type-specific category for datasets.

doctype
Document a data type for properties and codes.
doctype
Data type types categorize data types.
doctype

Store relevant information discovered today in your developer diary.

doctype

Categories for days.

doctype
Document a decision for an option. This is useful to state the reasons and the options that have been evaluated. Later other team members will have it easier to understand the decision.
doctype
Group your decisions by a self-defined type.
doctype
Deployments provide information about updates on services and systems to users.
doctype
Record a deployment to a IT system.
doctype

Type-specific category for deployment records.

doctype

Type-specific category for deployments.

doctype

Categories for diaries.

doctype
Document the usage of a doctype for your users.
doctype

Document the purpose and usage of the doctypes of this type.

doctype
Document the usage of a document property for your users.
doctype

Document the purpose and usage of the properties of this type.

doctype
Document the usage of a document section for your users.
doctype

Document the purpose and usage of the sections of this type.

doctype
Document logical or physical groups of nodes.
doctype
Type of an environment used by the project to deploy the application or the solution.
doctype
Associated an event with a day. A event is a collection of associated information for your later reference. Information may further be organized by subject, tags, categories, and audience.
doctype

Categories for events.

doctype
Excerpts are abstracts of information found in a resource, such as a book. If you want to go into more detail for a given resource, there may be multiple excerpts as subpages of the resource document.
doctype
Categorize excerpts by a type.
doctype
Defines the context through which readers acquire skills. The level sets the expectation on the author's techniques to teach.
doctype
Categorize experience levels by a type.
doctype
Categorize FAQs by a type.
doctype
Documents a feature of the product. The top features define the main aspects of the product.
doctype
Feature types categorize features.
doctype
Generic Documents provide information where no other doctype matches.
doctype
Categorize generic documents by a type.
doctype
Glossary items are part of the domain glossary for the project. Glossaries support the team to use terms of the domain consistently in conversations and documentation.
doctype
Categorize glossary items by a type.
doctype
Improvement proposals help to start the conversation within the team for process improvements.
doctype
Interfaces document how elements of the system communicate with elements of this and other systems.
doctype
Group interfaces by their type.
doctype
IT Activities define activities for processes.
doctype

Type-specific category for IT activities.

doctype
IT Assets define assets required or produced by processes.
doctype
Type-specific category for IT assets.
doctype
Document an Iteration that may be linked from JIRA. Allows the team to set the goal and add notes relevant to a particular iteration.
doctype
Functions are specialized organizational units to support business processes.
doctype

Type-specific category for IT functions.

doctype

IT Procedures define procedures for processes.

doctype

Type-specific category for IT procedures.

doctype
Processes organize activities to create a defined business value.
doctype

Type-specific category for IT processes.

doctype
IT Services provide business relevant services for customers.
doctype

Classifiers to categorize services.

doctype

Type-specific classification for IT services.

doctype

Signals the status of an IT Service.

doctype

Type-specific category for IT services.

doctype
Systems are part of environments where products are deployed to.
doctype
Systems are categorized by their type. These types may be quite concrete since systems by nature reference a hard- or software system usually by their IP address or DNS name. Therefore a system type may be 'Artifact Repository' or 'Virtual Server. And types may build hierarchies.
doctype

Add lifecycles to group lifecycle phases.

doctype

Lifecycle phases define phases that are bound to a lifecycle.

doctype

Locations provide information about the whereabouts of assets, configuration items, and systems.

doctype

Type-specific category for locations.

doctype
Resources are identified by their media type. This may be the MIME type, but also a human readable string, that identifies the syntactic format.
doctype
Categorize media types by their type.
doctype

Metadata documents provide tables of simple key/value pairs. This information can be used as an aspect or as additional space properties to be available for reference on your wiki.

doctype
doctype
Record the action items of a meeting.
doctype
Group your minutes by a self-defined type.
doctype
Define a mission for your company or product.
doctype

Type-specific category for mission statements.

doctype
A documentation module is a fragment which is usually transcluded by other documents. The lifetime of a module document is independent of the lifetimes of the documents that reference it.
doctype
Categorization of document modules for single sourcing.
doctype

Plan and run a retrospective for your month of work.

doctype

Categories for months.

doctype
Nodes are part of environments where artifacts are deployed to.
doctype
Node types categorize nodes.
doctype
Open issues document what the team needs to know to proceed.
doctype
Open issues are grouped by the severity of their impact on the project.
doctype
Open issues are grouped by the status.
doctype
Group your open issues by a self-defined type.
doctype
Document and track identified opportunities for the project.
doctype
Opportunities are grouped by their type.
doctype
Categorize organizations by a type.
doctype
Out item types categorize out items.
doctype
Document the purpose and usage of a page blueprint.
doctype

Document the purpose and usage of the page blueprints of this type.

doctype
Patterns provide solutions for problems in a given context. Patterns are usefull in multiple areas such as design, architecture, documentation, or process.
doctype
Patterns are divided into different domains to group patterns.
doctype
Categorize patterns by type.
doctype
Provides information about a person. This includes contact information (important if the person is relevant for the team) or information about the competences (if the person is an author about a topic relevant for the project).
doctype
Categorize persons by a type.
doctype
Document problems as a means to communicate the details and to use the information for reviews and retrospections.
doctype
Problems are grouped by their type.
doctype
Impacts define how the results of processes affect the world.
doctype

Type-specific category for impacts.

doctype
Outcomes define the results of processes.
doctype

Type-specific category for outcomes.

doctype
Product Backlogs are means to collect user stories.
doctype
Profiles provide views on documents via delegation.
doctype
Categorize profiles by a type.
doctype
Project Constraints limit the options of a project.
doctype
Project constraint types categorize project constraints.
doctype
Project Rules are defined by the team to enhance the collaboration and to define project standards.
doctype
Categorize project rules by type.
doctype
Frame the vision for a project or iteration.
doctype
Types to categorize vision statements for projects.
doctype
Properties are part of the configuration options of a system.
doctype
Property types categorize properties of products, such as parameters or configuration options.
doctype
Qualities describe desired aspects of the product.
doctype
Quality Scenarios document required qualities.
doctype
Quality scenario types categorize quality scenarios.
doctype
Documents a quality target for a product.
doctype
Group quality targets by their type.
doctype
Categorize quotes by a type.
doctype
Organizes glossary items.
doctype
Categorize relations by a type.
doctype
Releases document the changes that are applied to a published version of a service.
doctype
Document changes provided by a release of a product.
doctype
Group your release notes by a self-defined type.
doctype
Type-specific category for releases.
doctype
Reports document what the team has decided or done. This is a generic document.
doctype
Group your reports by a self-defined type.
doctype
Documents requirements of a product.
doctype
Categorization of requirements for a product.
doctype
Resources are books, webpages, videocasts relevant for the project. Add important information to your project about resources that lie outside the control of your team.
doctype
Resources are identified by their type. This is not the MIME type, but human readable string, that identifies the semantic, rather than the syntactic format.
doctype
Record the discussion of the team about their last iteration.
doctype
Plan and run your review meeting.
doctype
A single act to show on the review. Use this only if you have a lot to show or you want to reference the review results later. Often a simple numerated list is sufficient.
doctype
Document and track identified risks for the project.
doctype
Document actions to prevent or reduce the negative impact on exceptions on a project.
doctype
Risk actions are grouped by their type.
doctype
Risks are grouped by the phase of their impact on the project.
doctype
Risks are grouped by the probability of having impact on the project.
doctype
Risks are grouped by the severity of their impact on the project.
doctype
Document targets of risks.
doctype
Risk tagets are grouped by their type.
doctype
Risks are grouped by their type.
doctype
Defines a role with its responsibilities, tasks and requirements. Roles are incorporated by stakeholders who take interest in the project. The are also used to define the audience for documents.
doctype
Categorize roles by a type.
doctype
Sections of a document are typically part of a document. But the size of sections may vary. To support a team to write collaboratively on the documentation, a larger document may be subdivided into external section documents.
doctype
Categorize sections by a type.
doctype

Announcements communicate with stakeholders information about a service.

doctype

Type-specific category for service announcements.

doctype
Describe a service level for a service.
doctype
Provide information about a service level agreement (SLA).
doctype

Type-specific category for service level agreements.

doctype
Describe a requirement in terms of a service level.
doctype
Type-specific category for service level requirements.
doctype

Type-specific category for service levels.

doctype
Document the purpose and usage of a space blueprint.
doctype

Document the purpose and usage of the space blueprints of this type.

doctype
Compile other documents, yet space indices are themselves projectdoc documents. So they can be tagged and grouped.
doctype
Categorize space indexes by a type.
doctype
Space properties hold metadata of a space. They may be inherited by delegate spaces.
doctype

Document the purpose and usage of the space properties of this type.

doctype
A party that takes interest in a project. The stakeholder is either a real person, an organization or group, or represents a class of individuals, groups or organizations.
doctype
Categorize stakeholders by a type.
doctype
Describes a single step of an activity. A step is a generic document that is associated with a document that describes a process. It may be a test log or a howto.
doctype
Categorize steps by a type.
doctype
Defines a strategy for an organization or product.
doctype

Type-specific category for strategies.

doctype
Subject documents allow to set document instance of different doctypes in a common context.
doctype
Categorize subjects by a type.
doctype
Work on strengths, weaknesses, opportunities, and threats.
doctype

Type-specific category for SWOTs.

doctype
Document the semantics of a tag. May also be used to document Confluence labels.
doctype
Categorize tags by a type.
doctype
Document processes defined and used by the team.
doctype
Categorize team processes by type.
doctype
Technical Debts track issues to be paid back.
doctype
Technical Debts are grouped by the area they address.
doctype
Document a test case of your project.
doctype
Test case types categorize test cases.
doctype
Defines a charter to run an exploratory test session.
doctype
Test charter types categorize test charters.
doctype
Document data used for test cases.
doctype
Test data types categorize test data.
doctype
Documents the results of a test session for the sponsoring stakeholders.
doctype
Test report types categorize test reports.
doctype
Defines a document to collect information during a test session.
doctype
Test session types categorize test sessions.
doctype

Add a todo note to your developer diary.

doctype

Categories for todos.

doctype
Document tools used by the team. Add information about how to fetch, install and best practices using it.
doctype
Categorize tools by type.
doctype
A description of a given topic. A topic may describing or explaining a concept, a task to accomplish or a reference. There are a couple of topic types that set the expectations for the reader. Instances of the topic doctype usually have independent lifetimes from any referencing documents.
doctype
A topic type is a semantic type of the topic. It helps to set the expectations of potential readers.
doctype
Guided tours through existing information. This allows to aggregate topics for a given question or audience, thus providing a view on a topic.
doctype

Triggers define signals for activities and processes.

doctype

Type-specific category for triggers.

doctype
Defines a use case of the product.
doctype
Use case types categorize use cases.
doctype
User Characters are the actors of user stories. They include personas and extreme characters.
doctype
User character types categorize user characters.
doctype
User Stories document a requirement of a stakeholder with a specific business goal. It also provides an acceptance test. It is a representation of a unit of work.
doctype
Document a version of a product or service.
doctype
Categorize versions by a type.
doctype
Different views on the product help to document the system and its architecture. Typical views are building block, runtime, or deployment.
doctype
Groups the views at a system.
doctype

Describe your vision for your career.

doctype
Define the vision for your organization or product.
doctype

Type-specific category for vision statements.

doctype

Categories for visions.

doctype

Plan and run a retrospective for your week of work.

doctype

Categories for weeks.

doctype
Describe as a Whitebox the elements of a view where only the relations of internal elements are relevant.
doctype
Group whiteboxes by their type.
doctype
Work Instructions define procedures for processes. Provide the most detailed information here how tasks are to be executed. This includes best practices.
doctype
Type-specific category for work instructions.
doctype

Create a year in your Diary.

doctype

Categories for years.

doctype