Stackable Documentation

This is the main repository for the documentation of the Stackable platform. It uses Antora.

This repository hosts the Antora playbook file as well as some generic documentation modules.

To build the site install Antora and run:

antora antora-playbook.yml

Note	Antora caches all resources it downloads in the user’s cache directory (e.g. ~/.cache/antora directory on Linux). It will not automatically update those. Use the --fetch parameter to update all sources.

Development

Generating the documentation

During development, it can be helpful to use a playbook local-antora-playbook.yml which uses content from the local directory instead of the remote git repository.

content:
  sources:
  - url: ./
    branches: HEAD

Note	Antora does not recognize git submodules as git repositories

The design & layout comes from our UI repository.

LIVERELOAD=true gulp may be used to recreate the built documentation after each edit. The 'live reload' feature does not work over gitpod currently due to schickling/gulp-webserver#126

Remote IDE

A remote vscode instance can be used via https://gitpod.io/#/github.com/stackabletech/documentation