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, pull submodules, install dependencies and run make:

$ git submodule update --init
$ npm ci
$ make

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 flag (make ANTORAFLAGS=--fetch) 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. The playbook used by the Makefile can be overridden using the PLAYBOOK variable (run make PLAYBOOK=my-local-playbook.yml).

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