A little more about types of documents and relations between them in general
Documents
Contrary to lists, which are basically a collection of links, a document contains text that is subdivided in fields (for want of a better term).
Fields are separate blocks of text that can be modified. Each type of document contains a predefined collection of fields. Some fields are meant to contain only one line of text, others can contain as much text as necessary.
Documents are shown in either view (as shown above) or edit mode. In view mode buttons can be available to perform specific actions like defining relations; in edit mode the field contents can be changed. The modes can be switched with the actions selector or with the button labeled "wijzigen".
A summary of the document types in the various sections and subsections:
user documents: specifications, references, change requests, problem reports
design documents: references, user tasks, functions, data model
realisation documents: system tasks, processes, data items, layouts, programs
test-related documents: test plans, test situations and cases, test reports
More information about the content fields (and the types of relations mentioned below) can be found in the linked documents about the corresponding sections
Relations
The philosophy behind relations in this application is:
a relation-to implies that the related document should already exist
a relation-from means that the current document existed first; the consequence of this is that the document to be related to can be created from the page where the current document is shown
Once a relation is made, a link to the related document is shown together with a button that makes it possible to break the relationship.
Reference-to relations are meant to be made from the current document.
Reference-from relations are meant to be made from the other document, however it's also possible to make them from this document, in case both documents already exist.
For the case that a document that is meant to reference to the current one doesn't exist yet, it is possible to create it using an "add relation" button.
When a relation is made in one direction, it is automatically established in the opposite direction.