Introduction

The purpose of this guide is to provide an introduction to using the GitLab® platform and the AsciiDoc® markup language that will enable you to collaborate with members of The Open Group to create content.

A Focus on Book Format Publications

This guide focuses on the development of publications in book format, with supported output formats including html, pdf and ePUB. It should be noted that The Open Group also supports a separate toolchain for developing the online Digital Portfolio of Open Standards, however that is outside the scope of this guide.

About this Guide

This guide is for individuals who are participating in Forums or Work Groups within The Open Group. It includes guidance on the development of The Open Group publications using the AsciiDoc markup language in a GitLab® environment.

The high-level structure of this guide is as follows:

How to Use this Guide

It is recommended that as you read this guide you try out some of the examples shown.

Playground Projects

There are two playground projects set up to allow you to try out the GitLab environment:

  1. Cats and Dogs: a free-form project developing lists of cats and dogs

  2. The Cats and Dogs Standard: a project using The Open Group Standard Template

To be added to these projects, please contact Andrew Josey.