Create a library for your project. Reference books, podcasts, videos, and other resources that provide information on the topics relevant for your project.
Projects rely heavily on domain knowledge. Not all relevant information is created by the team. Instead the team stands on the shoulders of others. To make the relevant literature in its different formats available to all stakeholders, it is often helpful to collect these resources and make them accessible through the wiki.
A library is a space within the wiki to collect and analyse resources that are relevant for your project.
Creating a project library includes the following tasks:
- Add books, videos, audios, ... as resources to form a project library
- Create views on the library with resource types
- List authors to keep notes on people that are also interested in the domain of the project
- Collect interesting or inspiring quotes that are relevant for the project
- Attach excerpts to make the main statements of the resources quickly accessible to the team
Resources
Doctypes
The following doctypes (blueprints based on the projectdoc Toolbox) provided page blueprints to create a library.
| Resource |
Short Description |
Categories |
| 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. | |
| 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. | |
| Categories allow to set document instance of different doctypes in a hierarchy. | |
| Document the semantics of a tag. May also be used to document Confluence labels. | |
| 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. | |
| Quotes relevant for the project. Allows to store the content and metadata to the quote. | |
| 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). | |
| 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. | |
Macros
The following macros of the projectdoc Toolbox support creating or working with a library.
| Resource |
Short Description |
Categories |
| Renders a quote from a resource with author and source. | |
| Renders a quote to an external resource with author and source. | |
| Renders a cite to a resource document. | |
| Renders a template with property references. | |
| Lists references to projectdoc documents in a table. Allows to select document properties for columns. Also non-list representations are provided. | |
| Renders a predefined list of documents in a table. | |
