Home

Uyuni Documentation Wiki

Table of Contents

• Welcome!
• For contributors
• For developers

Welcome!

This is the official wiki for Uyuni and SUSE Manager documentation. Use the sidebar for common tasks.

For contributors

Writing process and tools

1. First steps

2. Setup our toolchain

3. Build the docs!

4. Create a pull request and have your work reviewed

5. Packaging and publishing (SUSE employees)

Additional Resources

• Getting started with Asciidoc

• Our writing and word usage guide

For developers

Toolchain architecture

• Toolchain architecture

Preparing a Pull Request

See Main repository README

Procedure: Setup The Toolchain

1. Setup rbenv and Ruby

   Easily manage your Ruby versions and gems with rbenv

2. Install NVM

   Easily manage your node package versions with the Node Version Manager.

3. Install Antora

   Upstream tool for generating our static HTML documentation pages.

4. Install Asciidoctor Gems

   Upstream gems for our adoc and pdf outputs.

5. Install po4a

   We use po4a to convert docs to gettext and back for translation.

6. How to Build Docs

   How to build our docs, tips and some gotchas.

7. Optional Tools