Helps team members to create documentation that is helpful, fosters the understanding of good and sustainable documentation and keeps the project's documentation up-to-date and clean.
- Group
projectdoc-gardeners
Resources
Name | Short Description | Doctype | Audience |
---|---|---|---|
This tour provides a list of links to reference material. |
tour |
||
Overview over the most relevant information for software developers to create their documentation on Confluence with the projectdoc Toolbox. |
tour |
||
Learn how to access projectdoc properties via REST API with cURL. |
topic |
||
Learn how to access projectdoc space properties via REST API with cURL. |
topic |
||
Agile documentation is not another buzzword. There is actually a set of rules to follow which will lead to meaningful documentation. Writing helpful documentation is not easy, but it gets a lot easier with the agile mindset - and with the projectdoc Toolbox. |
topic |
||
In addition to the properties specified in the document properties table, projectdoc provides additional properties drawn from Confluence or metadata. |
topic |
||
Add a document as a child and automatically make supplied properties available in the parent. |
topic |
||
Introduction to the autoconvert feature for URIs to external systems. |
topic |
||
Concepts central to projectdoc. Things users have to understand to get the most out of using projectdoc. |
topic |
||
Lists the configuration options for template authors to control page creation. |
topic |
||
projectdoc documents are stored in caches for quick access. Users may want to clear one of these caches. |
topic |
||
Overview over the different categories of macros that are part of the Information Systems Extension. |
topic |
||
A name in projectdoc used to identify a document is not considered a hard reference. When changing the name of a particular document, the references to the original name do not automatically change. This is by design. It may also by the cause of annoyance. This tip provides information how to deal with this. |
topic |
||
Information for the configuration options of the projectdoc Toolbox. |
topic |
||
The projectdoc Toolbox provides a number of features to help teams to reuse content. Content can be transcluded individually or in form of a multitransclude. Authors can even transclude content from multiple documents in the wiki, effectively combining transclusion with automatic lists. |
topic |
||
Deep links can be used on both sides of predicates in a Where Clause. |
topic |
||
Doctypes and the Name List Macro allow to specify a range of valid tokens for a value. These values can be rendered by applying specific CSS styles. |
topic |
||
Lists valid controls for properties to be used in document properties tables. |
topic |
||
Configuration to control how the projectdoc Toolbox handles property values with dynamic content. |
topic |
||
Property values should only change when a document is saved. They should not be dependent on request-time. If they are, then they are called 'dynamic'. |
topic |
||
The projectdoc Toolbox for Confluence provides a macro to merge tables. The macro also allows to filter on table rows. This tip provides a short overview. |
topic |
||
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. |
topic |
||
The Information Systems Extension for the projectdoc Toolbox allows to render a link with the HTML title as label via autoconvert of the pasted URL. |
topic |
||
Getting started with the projectdoc Toolbox is not easy. Some basic concepts are more than just good-to-know and the number of macros and doctypes may be simply overwhelming. This tip gives some advice on how to get started. |
topic |
||
Show how to use the Name List Macro to render links to glossary terms. |
topic |
||
Using sections and modules to organize and reference content. |
topic |
||
Categories provide easy navigation. The category page documenting the category automatically lists all documents tagged with this category. A defined set of categories has per default no such homepage. |
topic |
||
Lists recognized system properties specified on the command line for starting the Confluence server. |
topic |
||
Controls the parameter to use for running queries with the projectdoc Toolbox. |
topic |
||
Alter the rendering of macros of transcluded content with remote controls. |
topic |
||
Rescue and restore data of a Confluence page that does not render anymore. |
topic |
||
To access Confluence via its REST API with cURL you typically need to authenticate. Learn how to login with cURL and avoid some common security pitfalls. |
topic |
||
Define the default search space for index spaces. |
topic |
||
Define a doctype on document instances to select from its set of values. |
topic |
||
Lists the configuration options at space level. |
topic |
||
Lists valid controls for properties to be used as space properties. |
topic |
||
Show how to import properties from other projectdoc documents into a projectdoc document. |
topic |
||
Tools from the projectdoc Toolbox to allow users to browse for information. |
topic |
||
To organize your documentation place documents in a typed repository and add additional views on demand. |
topic |
||
In order to completely restore the projectdoc document index, not only must the Lucene index be re-created and the projectdoc document cache cleared, but the internal projectdoc structures must also be rebuilt. |
topic |
||
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. |
topic |
||
With the doctypeBorderImageServlet and some custom CSS it is possible to render a border image that contains the doctype name of the currently displayed Confluence page. |
topic |
||
Add a document as a child and automatically make supplied properties and sections available in the parent. A short walk-through to use the Aspect Feature in your information architecture. |
topic |
||
projectdoc makes it easy to create a modular documentation and provide multiple views on topics. |
topic |