Skip to content

Documentation

  • Set up in 15 minutes


    Install DRP and get up and running in minutes

    Getting Started
    Trial

  • Architecture - learning starts here


    Learn the features and methodolody of DRP.

    Architecture

  • Developers - building the automation now


    Build your own automation and integrations for DRP

    Developers

  • Operators - driving the system


    Operator DRP for maximum effect.

    Operators

  • Resources - information on demand


    Release information and FAQs for quick answers to specific questions.

    Resources

  • References - specific details


    Reference documentation on each workflow, stage, task, parameter in the system.

    References

Documentation Styles

RackN documentation follows the the Diataxis and Divio methodology. A consise summary is that there are four types of documentation.

  • Explanations- Articles or sections that describe the intent and methodology of a part of the product. These provide information from a perspective understanding the product.
  • How-To - Articles or sections that describe how something could be done. These provide methods for implementing features from a perspective of learning how to extend or expand the product.
  • Tutorials - Articles or sections that describe the specific actions to do something with the product. These provide steps or actions to a specific thing from a perspective if operating the specifics of the product.
  • References - Articles or sections that describe the specifics of a part of the product. These provide information from a perspective of looking up a fact or specific detail of the product.

The articles are tagged and grouped to make it easier to see there fit into the scheme.

Documentation Audiences

Documentation needs an audience. RackN Documentation defines three audiences.

  • Architecture- Articles or sections that are intended for architectural discussions. These are generally explanation articles intended for learning about how the system works and why.
  • Operator - Articles or sections that are intended for the operators of the product. These focus on operating, maintaining, and controlling the product.
  • Developer - Articles or sections that are intended for developers that are building new automation, extending current tooling, or integrating the product into their environment.

The articles are tagged and grouped to make it easier to see there fit into the scheme.

Using the Documentation

The tags help direct you understand the audience and content style, but search provides the methods to find what you are looking for. A couple of tips can help get more from your searching.

tags are included

Tags are included in the search indexes. By using a tag, you will get those pages that have that tag listed first in the search list. It allows for a fast filtering.

+ means required

By prepending a + to the term, it makes the term required for the search. Using this with tags, allows for restricting the first results to just that set of pages. Adding additional terms makes the search more specific.

Example

+install +aws

Will return first in the list, installation pages for AWS.