Skip to content
No description or website provided.
CSS Other
  1. CSS 99.6%
  2. Other 0.4%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
attic
eclipse
reference
.gitignore
.travis.yml
LICENSE
README.adoc
build.rb
package.json
run.sh
upload_docs.sh
watch-asciidoc

README.adoc

Yaktor Documentation Repo

Note
Please report issues at https://github.com/SciSpike/yaktor-issues/issues.

2. About

This repository contains the documentation for Yaktor, a scalable, event-driven, agent-based rapid development platform.

The documentation entry point is reference/index.adoc.

3. Authoring

It’s not terribly difficult to author documentation here. Understand the directory structure, then read how to build the docs.

3.1. Directory structure

  • reference: This is the entrypoint to the documentation. Most things are reachable from here, so that’s where you should start.

  • out: This is where the static HTML is written by asciidoctor. (It’s ignored by git.)

  • attic: This is old stuff that either needs to be removed, or needs to be updated and brought into the main documentation tree rooted in reference.

3.2. Building

This repo is built via asciidoctor. Instead of installing it & all of its dependencies, you can just use Docker from the root of this repository:

$ docker run --rm -v $PWD:/app -w /app yaktor/node:0.39.0 bash -c ./build.rb

If you want to author this documentation and continuously generate it on changes, you can either use the watch-asciidoc script in the repo root directory, which requires nodemon to be installed, or you can spin up your own filesystem watcher and invoke the docker command above yourself. Up to you.

You can’t perform that action at this time.