Aklivity Zilla Docs

Event-driven API Gateway

[![Build Status](https://github.com/aklivity/zilla/workflows/build/badge.svg)](https://github.com/aklivity/zilla/actions) [![Slack Community](https://img.shields.io/badge/slack-@aklivitycommunity-blue.svg?logo=slack)](https://www.aklivity.io/slack)

Documentation • Get Started • Examples • Blog

This repository contains the documentation website code and Markdown source files for docs.aklivity.io/zilla/.

Contributing Guide

Before submitting your contribution, please read through the following guide. We also suggest you read the Writing Guide in this repo.

Repo Setup

To develop locally, fork this repository and clone it in your local machine. Then run these commands from the root directory:

pnpm i

pnpm dev

Running Lints

Markdown linting

run:
```
pnpm lint
```

Spelling, grammar, and style lints

Install Vale then run:

vale src

vale --ignore-syntax src/.vuepress/sidebar/en.ts

Link checking

Install Lychee then run:

lychee --exclude-mail src

Running compiled site link checking:

pnpm link-checker && lychee --exclude-mail --base="src/.vuepress/dist" src/.vuepress/dist

Reference docs Structure

Pages in the reference section describe, as briefly as possible and in an orderly way, the properties and interface of a feature.

h1(#) - Title
- Include description and Full example codeblock
h2(##) - Page section
h3-6 - Properties
- h3(###) - Top level
- Top level props should(not mandatory) include an addition codeblock example including the entire example
- h4-6 - Header level correlates with path depth
- Child property headers reference the parent
- #### parent.child
- Arrays of objects have brackets [] only when describing child properties
- #### parentArray[].child
Required props have an escaped splat \* at the end of the header and ToC link
- ### topLevelProp\*

# Title

Description.

```yaml
topLevelProp:
  child: example
array:
  - one
  - two
parentArray:
  - child: one
  - child: two

Section

:::: note ToC

topLevelProp*
- topLevelProp.child*
array
parentArray
- parentArray[].child

::: right * required :::

::::

topLevelProp*

object

Description.

topLevelProp:
  child: example

topLevelProp.child*

type | Default: value

Description.

array

array of primitive

Description.

array:
  - one
  - two

parentArray

array of object

Description.

parentArray:
  - child: one
  - child: two

parentArray[].child

type

Description.


### Generate schema asset

capture the output and delete the first and last lines

```bash
docker run -it --rm -e ZILLA_INCUBATOR_ENABLED=true ghcr.io/aklivity/zilla:latest start -v -Pzilla.engine.verbose.schema > src/.vuepress/public/assets/zilla-schema.json

pnpm check-schema > schema-edits.txt

Provide feedback

We’d love to hear your feedback. Please file documentation issues only in the docs GitHub repository. You can file a new issue to suggest improvements or if you see any errors in the existing documentation.

Every page has an Edit this page on GitHub link at the bottom for you to check the page source and report specific issues.