From b928d81b3129986640719480a31d405a97769368 Mon Sep 17 00:00:00 2001 From: Keith Hazelton Date: Fri, 26 May 2023 06:56:24 -0500 Subject: [PATCH] Update Documentation-as-DevOps.adoc --- Documentation-as-DevOps.adoc | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/Documentation-as-DevOps.adoc b/Documentation-as-DevOps.adoc index a863a4f..de9b73c 100644 --- a/Documentation-as-DevOps.adoc +++ b/Documentation-as-DevOps.adoc @@ -1,6 +1,6 @@ === Documentation-as-DevOps -==== One Option +==== Proposal . Review Evolveum Documentation: https://docs.evolveum.com/, and their writing processes: https://docs.evolveum.com/about/writing-documentation/, https://docs.evolveum.com/about/asciidoc/ . Migrate existing content from Confluence XHTML to asciidoc: https://docs.asciidoctor.org/asciidoctor/latest/migrate/confluence-xhtml/ @@ -14,11 +14,6 @@ - Evolveum documentation site: https://docs.evolveum.com - Asciidoc: https://asciidoc.org - Markdown: https://www.markdownguide.org/ -- Antora: https://antora.org/ "multi-repository documentation site generator for tech writers writing in AsciiDoc" -- Github Pages or Gitlab Pages (Auto Re-Publication on commit to repo) -- https://pages.github.com, https://docs.gitlab.com/ee/user/project/pages/ -- Gitlab Demo ‘source’: https://gitlab.com/antora/demo -- Gitlab Demo published version: https://antora.gitlab.io/demo/docs-site/component-b/2.0/index.html -- Pros and Cons of Markdown vs Asciidoc: https://www.slant.co/versus/1903/23065/~markdown_vs_asciidoc -- Jeff Sandberg, "I wish asciidoc was more popular": https://pdx.su/blog/2023-02-05-asciidoc-and-markdown/ +- Github Pages: https://pages.github.com (Auto Re-Publication on commit to repo) +-