pegleg/README.rst
Felipe Monteiro 95996a4957 trivial: Fix README documentation badge
This patch set fixes the README badge which isn't rendering
correctly (e.g. [0]). Thus it has been changed to [1]. Also
adds image build status via a badge, similar to Armada [2].

[0] https://github.com/openstack/airship-pegleg
[1] https://readthedocs.org/projects/airship-pegleg/badge/?version=latest
[2] https://raw.githubusercontent.com/openstack/airship-armada/master/README.rst

Change-Id: I25d3c8a78735adee7bb858b1dfff61714162a52c
2018-10-02 18:29:45 -05:00

2.0 KiB

Pegleg

Docker Repository on Quay Doc Status

Introduction

Pegleg is a document aggregator that provides early linting and validations via Deckhand, a document management micro-service within Airship.

Pegleg supports local and remote Git repositories. Remote repositories can be cloned using a variety of protocols -- HTTP(S) or SSH. Afterward, specific revisions within those repositories can be checked out, their documents aggregated, linted, and passed to the rest of Airship for orchestration, allowing document authors to manage their site definitions using version control.

Find more documentation for Pegleg on Read the Docs.

Core Responsibilities

  • aggregation - Aggregates all documents required for site deployment across multiple Git repositories, each of which can be used to maintain separate document sets in isolation
  • linting - Configurable linting checks documents for common syntactical and semantical mistakes

Getting Started

For more detailed installation and setup information, please refer to the Getting Started guide.

Integration Points

Pegleg has the following integration points:

  • Deckhand which provides document revision management, storage and rendering functionality upon which the rest of the Airship components rely for orchestration of infrastructure provisioning.

Further Reading

Airship.