Content Structure

Content in Alliage is structured using three main concepts: organizations, projects, and documents.

Organization: An entity with one or multiple projects.

Project: Collection of documents.

Document: Association of contents and metadata properties.

Collaborators have different permissions managed at various levels via roles.

Document

A document is the main unit of work. Depending on their categories, not all documents are the same.

They contain shared metadata properties defined at project level as well as category specific properties.

Example

The following project is an example of how this structure works.

Knowledge base project

The project contains 5 categories with the specific content properties:

  • Card
    • Description
    • Content
  • Issue
    • Observation
    • Diagnostic
    • Reproducibility
    • Workaround
    • Solution
  • FAQ
    • Description
    • Response

Some metadata may accept a single possible value. For example:

  • Status
    • Opened
    • Handled
    • Solved
    • Outdated
    • Defunct
  • Severity
    • DEBUG
    • INFO
    • WARNING
    • ERROR
    • FATAL

Other metadata may accept multiple values. For example:

  • Components
    • list of useful components
  • Platforms
    • list of useful platforms
  • Tags
    • list of useful tags

This information is used to describe the documents and quickly find and filter related content easily.