Aklivity Zilla Docs

Event-driven API Gateway

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)
  - [topLevelProp.child\*](#toplevelprop-child)
- [array](#array)
- [parentArray](#parentarray)
  - [parentArray\[\].child](#parentarray-child)

::: right
\* required
:::

::::

### topLevelProp\*

> `object`

Description.

```yaml
topLevelProp:
  child: example
```

#### topLevelProp.child\*

> `type` | Default: `value`

Description.

### array

> `array` of `primitive`

Description.

```yaml
array:
  - one
  - two
```

### parentArray

> `array` of `object`

Description.

```yaml
parentArray:
  - child: one
  - child: two
```

#### parentArray[].child

> `type`

Description.

Generate schema asset

capture the output and delete the first and last lines

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.

Copyright and license

Copyright Aklivity, Inc. 2024, released under the Apache 2.0 license.