Tutorials

First Steps With Studio: Technical Documentation Tutorial

Updated: March 18, 2024

This tutorial offers a progressive and educative tour of what you can do to customize the Nuxeo Platform with Nuxeo Studio. It could be one of the first tutorials you do.

In this sample use case, we will use the Nuxeo Platform to manage technical documentation. It will be important to make it easy to differentiate draft documentation items from validated ones. We will implement the publishing logic using the Nuxeo Platform.

Here are a few rules we want to follow:

  • A technical documentation document is called a "documentation item". Documentation items can be procedures, notices or installation instructions.
  • A documentation item is composed of an office file and a set of descriptive metadata.
  • When looking at a documentation item we should only display needed information, nothing else.
  • All documentation items should be stored in one place. This means it should be easy to filter documents by properties.
  • The document listing should display the useful metadata immediately.
  • A workflow should be available to validate a document easily.
  • A newly created documentation item should be editable only by its creator until the validation workflow is started.
  • Publishing should be automatic at the end of the validation workflow.

This how-to is divided in the following main steps: