widmogrod/run-the-docs

Keep code and documentation in sync. Run code examples in a browser

Installs: 13

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 1

Forks: 0

Open Issues: 1

pkg:composer/widmogrod/run-the-docs

dev-master 2017-12-28 21:33 UTC

This package is auto-updated.

Last update: 2025-10-07 20:41:24 UTC


README

Introduction

Keep code and documentation in sync. Run code examples in a browser.

Specificaton (Draft)

Core concepts

  • Language agnostic. Generates documentation from any programming language.
  • Code is documentation. Keeping documentation inlined in code makes it's easier to be in sync with actual state of the codebase.
  • Examples are tests. Having examples as a test protects them from being outdate and therefore documentation from becoming obsolete.