All Projects

Technically a plugin for Jekyll SSG that paginates AsciiDoc documents, inspired by mdBook. Basically, it breaks a book down into a website, wrapping it in Just the AsciiDocs theme.

The Educational Document Utilities framework for authoring and maintaining curriculum matter, such as textbooks, workbooks, slide presentations, quizzes, exams, grades, and so forth. Share curriculum in forkable repos, which other instructors can use to adapt to their own situations. Generate study materials, presentations, and tests, all from a single source of truth. Will extract framework from docs-as-code-school repo.

Jekyll website theme for version-controlled technical documentation across multiple products. Accommodates extra categorization, navigation features, multiple search engines, AsciiDoc styling. The most complex and most powerful product.

AsciiDoc. YAML. Liquid. A three-language approach to managing complex, multi-variant documentation. This “tech stack” maximizes power while minimizing syntax overhead, making advanced documentation techniques accessible to beginners while remaining powerful enough for enterprise needs.

A domain-customized CommandLine-Integrated Documentation Environment utility for automating document management tasks, including project initiation, new-file stubbing, scripted-build execution, and Git-related functions. A way to organize and execute your own scripted procedures using simple, semantic commands. Clide has preset grammars and workflows for different domains/frameworks: tech docs/AsciiDoc Ops, legal docs/LegalDoc Ops, and educational docs (Liquid EDU).

For freelancers and agencies. Manage contracts and invoices in a code-like manner. Track payment data as YAML and generate invoices in PDF and HTML, via Asciidoctor. Maintain a prime contract in AsciiDoc, and have clients digitally sign private variants using Git and GPG.

Implementation of SchemaGraphy for using YAML/Liquid to define and even script commandline interfaces. This is an API/platform for configuring custom CLIs for document processing and manipulation.

Manager for DocOps Docker images and containers. Simplifies building, running, and managing DocOps development environments via Docker.

A Docker-containerized environment and shell script for reducing the complexity of setting up “developer tools”. Non-developers can run a single command (docksh run) and instantly access whole runtimes and specialized documentation tools in a pre-configured shell environment.

A development utility that centralizes authoring of common configs, styles/rules, and documentation for sharing across all DocOps Lab project repos. Provides a numer of Rake tasks for maintaining consistency of distributed libraries and assets used in development of DocOps Lab tools but not necessary for using said tools.

Structured education in modern technical documentation and document processing. Starting with “Deep Semantics” (Fall 2025?) and expanding to courses on version management, code-like workflow adoption, and legal document operations, this project uses docs-as-code to teach docs-as-code principles.

Generate dynamic, jQuery-backed HTML5 forms from YAML files and collect data online. Build interactive web forms with validation, conditional logic, and data collection capabilities.

CLI utility for executing OpenFormY operations. Use formy to validate, initiate, document, or abstract HTML5 forms according to OpenFormYML definition documents.

CLI utility for executing SchemaGraphy operations. Use graphy to validate, parse, and manipulate SGYML data objects and AsciiDoc documents according to SchemaGraphy definition documents.

A CLI for bulk creating issues in cloud-based systems like Jira and GitHub Issues. Introduces an open standard called IMYML for defining individual issue entries and default settings such as global labels, milestones, and assignees.

A Docker image preconfigured with Issuer and ReleaseHx CLIs and their dependencies. For managing issue tickets and release notes/changelogs in Jira, GitHub, and GitLab.

100% YAML-sourced Agency Bootstrap landing page — no messing with HTML. Even ingest existing product data to source page elements. Quickly add a landing page to your product docs, either for promoting your product itself, or for introducing the docs, or both, or one for each.

A plugin that helps integrate API references generated by various tools that generate documentation from native code and comments. Copies their headerless/footerless HTML output, infers metadata, inserts frontmatter, generates NavMap data.

Disambiguation and coordination of the core components of an application based in our Jekyll/Asciidoctor-based publishing framework. These utilities make up the Jekyll publishing aspect of a typical Asciidoctor, Jekyll, and Clide-based toolchain, but they can readily be used independent of that toolchain.

This is a unified docs site for the various plugins and themes based on jekyll-asciidoc-ui. The intention is for this plugin to differentially feed all of these extensions with core options and a means for each plugin to incorporate these libraries into its own gem or application.

A simple landing page theme for Jekyll sites that use AsciiDoc. Based on the Minimal Mistakes theme. Includes AsciiDoc-friendly templates and jekyll-asciidoc-ui assets.

A set of Jekyll plugins and themes that enrich AsciiDoc web output. Includes themes like AsciiDocsy and Just The AsciiDocs, plus plugins for Jekyll-OpenAPI integration, adocBook document converter, and 25 UI extensions for AsciiDoc.

Templates and plugin integrating the simplistic jekyll-hyde theme and the jekyll-asciidoc plugin and (optionally) adocBook chunking.

A plugin that extends Jekyll with core capabilities key to DocOps Lab Jekyll extension projects but broadly useful to Jekyll plugin and theme developers.

Templates and plugin for extending the excellent Just the Docs Jekyll theme to be AsciiDoc friendly and accommodate components of AsciiDocsy as well as nav features. This is a dark-mode theme highly consistent with the light-mode Material MkAdocs plugin.

Templates and plugin for extending the Material-based MkDocs Jekyll theme, which mimics the MkDocs utility project and the Material Design website theme system. This is a light-mode theme highly consistent with Just the AsciiDocs plugin.

A plugin that extends Jekyll SSG with AsciiDoc-friendly OpenAPI (OAS3) REST API docs. Includes paginated format, AsciiDoc in description fields, and code-sample handling.

A plugin that provides a version-handling framework to Jekyll sites. Includes version-mapping data structures and front-end components.

A sample REST API with OpenAPI 3.0 spec, Postman collection, and example client code in Ruby, Python, and JavaScript.

LAB is the core project/switchboard for DocOps Lab. It is home to the YAML file that defines all of its projects (the source of the very text you are reading now). It also hosts policy and procedural documentation and key assets like common scripts and data files, testing scripts, testing images, and more. LAB is also the source of assets for the sites rooted in docopslab.org (and docops.github.io).

Framework for managing legal documents like code, with AsciiDoc and YAML. Includes client intake, metadata handling, and document/contract drafting, rendering, and even digital signing procedures. Even includes Creative Commons-licensed starter templates for end-of-life planning documents and employment contracts, with proceeds from professional use to benefit National Lawyers Guild.

Low-code template parser and build tool, specializing in Liquid and AsciiDoc, scriptable with YAML and Liquid. Includes complete Ruby API and CLI for document generation and processing workflows.

CLI utility for executing OPYML operations. Use opathy to validate, initiate, document, or abstract filesets according to OpenPathy definition documents.

A YAML syntax for defining, validating, documenting, and spawning fileset structures. Create reproducible directory structures and file templates with comprehensive validation.

A utility for managing product release history, notes, and changelog. Includes a Ruby API and CLI, releasehx/rhx. Includes SchemaGraphy prototype.

Data Schema specifications or requirements docs for specialized SGYML (YAML) data objects, for governing flat-file data sources as code. These standards specify how end users can create custom definitional documents out of these syntaxes and process them. These natural-language specifications and their SGYML Schema counterparts dictate: how SchemaGraphy validators, parsers, and other supporting utilities should be configured to process SGYML documents in specific syntaxes. This monorepo includes full documentaton of each “spec”, though contents are mainly sourced in separate repos alongside a flagship API for the given syntax.

Extends YAML through SGYML and accompanying libraries, providing advanced data typing and document transclusion capabilities. Provides a full-featured schema language that allows users to define complex data structures, document structures, and whole interfaces in a single, unified format.

A fiddle-like web application for testing and demonstrating schema/data and schema/text combinations. Online playground for experimenting with SchemaGraphy schemas and validations.

A RESTful API service for processing schema/data and schema/text combinations without installing SchemaGraphy libaries locally.

A library for pre-build and build-time documentation processing for strict single sourcing of application docs. Provides Ruby API for extracting, parsing, and manipulating AsciiDoc content and YAML/SGYML data programmatically.

A CLI utility for substituting text in files based on regex definition pairs. Use SubTxt to perform bulk text substitutions across multiple files using simple YAML mapping files.

A model for describing, defining, and mapping all manner of product and documentation divergence, enabling other systems to coordinate and conform to them. Presents the logic for VMYML markup framework.