Skip to content

Commit

Permalink
Update Documentation-as-DevOps.adoc
Browse files Browse the repository at this point in the history
  • Loading branch information
khazelton authored May 26, 2023
1 parent 58690a3 commit b928d81
Showing 1 changed file with 3 additions and 8 deletions.
11 changes: 3 additions & 8 deletions Documentation-as-DevOps.adoc
Original file line number Diff line number Diff line change
@@ -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/
Expand All @@ -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)
-

0 comments on commit b928d81

Please sign in to comment.