Get users started with collecting external information that is relevant for their project. Each piece of information is referenced by a resource document. Excerpts and quotes are used to catch detailed information and make it referenceable.
Create a Space
The library may be part of your project space or in a separate space. If you choose to create a separate space, the topic space may be the most appropriate type of space.
The space provides home pages for resources, quotes, persons, and organizations.
The overview section may provide information for users on how to work with the library. Tours may provide manually created lists of introductory material or resources that are relevant for a given task. You may also create a glossary for the terms of the domains in this space.
Use the Resource Doctype
For each relevant information add a resource document that references this information.
The resource documents will automatically be collected on the Resource Doctype's Index Page. Usually you will add the resource document to the Resource Doctype's Homepage, which forms the library of external resources.
For more information about this concept: Home and Index Pages.
Specify the Resource Type
Add the appropriate Resource Type to the resource document in order to structure the resources by their type.
A website provides information that differs from a book. Adding the resource type sets the right expectations by readers and allows this value to be rendered in lists.
In order to use the resource type, you have to select and create documents for the types that are relevant for your project. You may want to refer to Resource Types (Prototypes) to get you started with some examples.
Use Categories and Tags
To provide different views on the resources of your library, define categories and tags using the Category and Tag Doctype.
You may further organize your library by defining audiences and subjects.
Each resource is then associated with the intended audience, a subject, categories, tags.
Assume to define a category '/ Information Architecture'. Then associate a book with this category.
The resource in view mode:
By clicking on a category '/ Information Architecture' users are able to examine other resources for this category that are available in the library.
Name the Author
If you reference the author of a resource that matches a person document, the resources and quotes for that person are automatically collected.
Example with Jurgen Appelo from our Library
The following example is taken from our internal library at smartics. It shows the books written by Jurgen Appelo and (some of the) quotes found in these books.
Person documents will themselves be collected in a person register on the Person Doctype's Home and Index Pages.
If you want to factor out information for authors that work together within an organisation, use the Organization Doctype.
