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

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

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

This projects uses the free Algolia Docsearch tool to index the production site for all of the public versions. The crawler config is based on the recommended config from the Docsearch Plugin.

To see the current search index or crawler config login to the Algolia Dashboard.

• 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

• Schema checking

  You can automatically check the reference docs against the Zilla json schema. More instructions are in the .check-schema/README.md

  pnpm check-schema > schema-edits.txt

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

### 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.

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 Aklivity, Inc. 2024, released under the Apache 2.0 license.