DocOps Lab

Bridging the gap between documentarians and the world of code

I am working to distribute the power of docs-as-code for non-developers. Too many technical writers, project managers, paralegals, researchers, and educators are stuck with legacy document tools that constrain their potential.

The Bridge I'm Building

Through several interconnected open source projects, I'm creating pathways for "tech-savvy non-programmers" to harness developer tools for document operations.

DocOps Box

This project provides a Docker-containerized environment that eliminates the complexity of setting up development tools. Non-developers can run a single command (docksh run) and instantly access Ruby, Git, Node.js, Python, Pandoc, and specialized documentation tools in a pre-configured shell environment.

Docker Zsh Ruby Asciidoctor Git Pandoc Node.js

Docs-as-Code School

Structured education in modern technical documentation and document processing. Starting with "Deep Semantics" 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.

Education AsciiDoc Semantics Workflows Legal Docs Versioning

AYL DocStack

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.

AsciiDoc YAML Liquid Templates Automation Frameworks

SchemaGraphy

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.

  • Advanced data typing and validation
  • Document transclusion ($ref pointers)
  • Unified schema language
  • Complex structure definitions
YAML SGYML AsciiDoc Markdown Schemas Validation

Jekyll-AsciiDoc Extensions

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.

  • AsciiDocsy theme
  • Just The AsciiDocs theme
  • Jekyll-OpenAPI integration
  • 25 UI extensions for AsciiDoc
Jekyll AsciiDoc Themes Plugins Utilities Open API

ReleaseHx and Issuer

Issue-ticket creation and release-history management tools that integrate with Jira, GitHub, and GitLab. Bulk-create work items from a single YAML file, then generate release notes and changelogs in AsciiDoc, Markdown, YAML, JSON, HTML, or PDF formats at release time.

  • Jira, GitHub, GitLab integration
  • Bulk work item creation from YAML
  • Automated release notes generation
  • Advanced configuration
Jira GitHub Issues GitLab Issues YAML Release Notes CHangelog

Join the Movement

The goal of all this is to create a "docs-as-code" ecosystem that enables developers and non-developers alike to leverage modern documentation practices through a proper set of technologies, strategies, and conventions.

Follow DocOps Lab Join Community Chat