Skip to content

Kavinraja-G/crossplane-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

crossplane-docs

What is XDocs?

  • We have XR, XRD, XRC ;) Why not XDocs?
  • Inspired from terraform-docs but for Crossplane
  • Generate markdown based docs for your Compositions, it also includes your linked Resources, XRD and Claim

Installation

XDocs Generator can be installed in several ways to suit your preferences and development environments

Homebrew Tap (macOS & Linux)

If you're using Homebrew, you can install the tool via our custom Homebrew tap

brew tap Kavinraja-G/tap
brew install crossplane-docs

Standalone Binary

For macOS, Linux, and Windows, standalone binaries are available. Download the appropriate binary for your operating system from the releases page, then move it to a directory in your PATH.

macOS/Linux

# Feel free to change the release/arch names accordingly
curl -Lo crossplane-docs https://github.com/Kavinraja-G/crossplane-docs/releases/download/v0.1.0/crossplane-docs_v0.1.0_darwin_amd64.tar.gz
chmod +x crossplane-docs
sudo mv crossplane-docs /usr/local/bin/

Windows

Download the .exe file and add it to your PATH

Usage

Currently xDocs supports only markdown output, but more in pipeline. To generate markdown docs for your compositions & XRDs

# Generate markdown docs for given compositions and XRDs
crossplane-docs md [INPUT_PATH] -o [OUTPUT_FILE]

# In some cases users prefer to generate XRD docs since pipeline mode is not supported
crossplane-docs md [INPUT_PATH] -o [OUTPUT_FILE] --xrd-only

For example:

crossplane-docs md ./samples -o samples/README.md

Check README.md for the output.

Features

  • Discovers Composition & its resources, XR, XRD and Claim names with their references
  • Markdown ouput with tabulation
  • Supports generating only XRD docs
  • Claim/XRC specifications

Limitations

Crossplane compositions with Pipeline composition mode is not supported.

License

Distributed under the Apache-2.0 License. See LICENSE for more information.