Skip to content
Erika Heidi edited this page Jan 18, 2024 · 8 revisions

Welcome to the autodocs wiki!

Autodocs is a PHP library designed to facilitate building highly customizable automated docs based on on markdown templates and JSON data sources. It provides a layer of abstraction on top of which you can create your own documentation factory.

Autodocs was built to be combined with a Minicli application, making it suitable for running as a scheduled task on GitHub Actions.

Requirements

  • PHP >= 8.2
  • Composer
  • ext-json

For a detailed guide on how to implement an Autodocs application, check the tutorial on DEV: Creating an Automated Documentation Pipeline in PHP with Autodocs and GitHub Actions. It covers everything from bootstrapping a new Minicli app and configuring it with Autodocs, creating a custom documentation page, setting up a JSON data source, and setting up a custom layout for a README page. The tutorial also covers how to create a GitHub Actions workflow to run this application and create a pull request when there are changes in the generated docs.

Demo

A demo implementation that generates JSON-based README files is available in this repo: https://github.com/erikaheidi/autodocs-demo

Clone this wiki locally