Tour through the documentation for users who want to learn to create documents based on projectdoc doctypes.

Audience: Author

This tour guides you to the information that is relevant for document authors to get to know the relevant doctypes, macros and conventions of projectdoc quickly.

Quick Overview

projectdoc in Action is a series series of screencasts that provides some overview and hands-on videos.

Watching them will get you an impression of what projectdoc can do for you.

Concepts

Basic Concepts and Conventions for projectdoc is a selection of topics that will introduce the central conventions of projectdoc.

Knowing them will make it easier for you to use doctypes and macros.

Core Doctypes

Take a gentle introduction to the doctypes provided by the core doctypes add-on.

Doctypes are essentially templates for various types of documents that help you get startet quickly.

Since doctypes often need to be adjusted by template authors our templates are available as open source.

The list groups the core doctypes semantically. This may help new users to learn about the core doctypes and to know when to use which.

Generic Categories: Categories that are defined to be used with any doctype. So any document instance defined for these categories has to make sense for any doctype.
Type-specific Categories: Categories that are defined to be used for a specific doctype. May be used for a couple of doctypes, but is not intended to make sense for any doctype.
Aggregating Doctypes: Doctypes to help organize the space. This includes homepages for particular information (like the homepages for each doctype) and tours that provide a specific view on existing documentation.
Modular Content Doctypes: Doctypes that help to write modular documentation and therefore support single sourcing.
Documenting Doctypes: These are the generic working horses that are used whenever no specific doctype matches the intention of the author.
Subordinate Documents: Subdocuments are associated with the lifetime of the parent document. The section doctype is the most generic type of document, but there are others, that are specific to a certain doctype.
Specific Doctypes: A list of doctypes that have a specific purpose. The core doctypes are none-the-less quite generic so that they can be used in almost any project.
Generic Doctypes: What if no existing doctype matches the purpose of the document? Here are some tips how to handle this situation.

Or have a look at an overview over all doctypes.

If you just need to have an overview of the existing types, please check the Doctypes page.

Macros

Take a gentle introduction to the macros provided by the projectdoc Add-on.

The list groups the core macros semantically. This may help new users to learn about the core macros and to know when to use which.

Referencing Macros: Macros to help authors to reference other documents that are relevant to the current document.
Structuring Macros: Macros to help authors to a document structure so that the information is easier to understand.
Modular Documentation Macros: Macros to support single sourcing for creating modular documents.
Visual Macros: Macros to render information in a visually appealing format.
Document Development Macros: Macros that help authors to create templates and content.
Collaboration Macros: Macros to support a team to write their documentation collaboratively.

An alternative View on projectdoc Macros

Extension Doctypes

The following doctypes are provided by extension add-ons.

Some doctype and extension add-ons are currently still under development. They will be available for download on the Atlassian Marketplace soon.

Add-ons labelled as AVAILABLE SOON are already published on Bitbucket.

ABOUT TO BE AVAILABLE indicates that the add-on has been released to the Atlassian Marketplace and is waiting for approval.

Add-ons with status AVAILABLE are published on the Atlassian Marketplace and on Bitbucket.

Add-ons marked as NOT YET PUBLISHED are currently under development. Please get in touch if you need to know about the release plan!

POSTPONED indicates that the add-on is no longer under active development to be released on the Atlassian Marketplace, but still available on Bitbucket.

Name	Status	Short Description
Doctypes for Software Development	AVAILABLE	Provides doctypes to create documentation in software development projects. The focus is on documenting the architecture of the product, but it includes templates for other software development documentation requirements as well.
projectdoc Add-on for arc42	AVAILABLE	Provides doctypes to document a system or software architecture based on the arc42 Template.
Doctypes for Agile Planning	AVAILABLE	Provides doctypes to collborate with your team. Run iterations and record discoveries that may be of interest at the end of the iteration or for even later reference. Quick notes are more easily added as records to the team's space than to the official documentation tree. Defer the talk to the documentation architect to the end of the iteration (if the discovery is still of interest).
projectdoc Developer Diaries	AVAILABLE	Provides doctypes to organize the developer's work by the employment of a diary. Take you personal planning and professional records to the next level!
Doctypes for Teamwork	AVAILABLE	Provides doctypes to define the checklists, processes, patterns, tools, and rules your team agrees upon. Writing them down makes them accessible for anyone - especially for new team members. Keep these documents short and to the point!
Doctypes for Business Strategy	AVAILABLE	Mission, vision, strategy for business planning and execution.
Doctypes for Service Management	AVAILABLE	Provides doctypes to document services and systems for IT service management (ITSM).
Doctypes for Project Management	AVAILABLE	Provides doctypes for documenting decisions, risks, open issues, and meeting minutes.
Doctypes for Risk Management	AVAILABLE SOON	Provides doctypes for documenting and tracking risks.
Doctypes for App Manuals	AVAILABLE SOON	Document macros, page blueprints, space blueprints, and components of your Confluence add-on.
Doctypes for V-Modell^®XT	AVAILABLE	Use products (templates) from the V-Modell^®XT in your Confluence wiki as blueprints!

List of Extensions

The following extensions are available for the projectdoc Toolbox for Confluence.

Name	Version	Status	Short Description
Bookmarklets Extension	3.0.0	AVAILABLE	Add-on to extend the Toolkit with Bookmarklets. Allows to execute tools via the browser.
Graph Extension	1.0.0.b3	NOT YET PUBLISHED	Add-on to extend the projectdoc Toolbox for drawing document graphs.
Information Systems Extension	8.0.0	AVAILABLE	Add-on to extend the projectdoc Toolbox to integrate remote information systems.
Maven Extension	5.0.1	DEPRECATED	Add-on to extend projectdoc for Confluence with Maven Tools.
Web API Extension	13.1.0	AVAILABLE	Add-on to extend projectdoc with an API to access on the web.

The Maven Extension is no longer actively developed and will not be available on Confluence Data Center. The Bookmarklets Extension is currently checked for suitability on Confluence Data Center.