Skip to content

README.adoc

Latest commit

 

History

History
42 lines (28 loc) · 1.08 KB

README.adoc

File metadata and controls

42 lines (28 loc) · 1.08 KB

Docs-as-Code

This repository hosts the source for the https://docs-as-co.de website — a lean, vendor-neutral guide to Docs-as-Code that funnels readers towards docToolchain.

Stack

  • Plain static HTML + CSS (no framework, no build step)

  • Progressive enhancement: the site is fully readable with JavaScript disabled

  • Deployed via GitHub Pages (see .github/workflows/pages.yml)

Structure

site/

The published website (HTML, assets/, CNAME).

.github/workflows/

GitHub Pages deployment workflow.
Note
 The previous Jekyll/AsciiDoc version of this site lives in the git history; see the commits before the static relaunch.

Develop locally

Serve the site/ folder with any static web server, for example:

python3 -m http.server --directory site 4000

Then open http://localhost:4000 .

Deploy

Pushing changes under site/ to master triggers the GitHub Pages workflow, which publishes the site/ folder to https://docs-as-co.de .

Authors

Ralf D. Müller & Gernot Starke