diff --git a/slides/README.md.old b/slides/README.md.old
new file mode 100644
index 0000000..bce6e58
--- /dev/null
+++ b/slides/README.md.old
@@ -0,0 +1,445 @@
+---
+marp: true
+theme: default
+style: |
+ footer {
+ position: absolute;
+ #left: 50%;
+ bottom: 7px;
+ }
+ section header a { color: white;}
+ video.inslide {
+ position: absolute;
+ width: 70%;
+ height: 70%;
+ }
+paginate: false
+footer: '[github/ojacques](https://github.com/ojacques) [github/angegar](https://github.com/angegar)'
+---
+
+
+
+
+
+
+# CI and CD
+## For documentation
+
+
+
+---
+
+
+
+
+---
+
+
+The quest for great documentation
+
+# π°π¦π€΄πΈπ΄π»βπ‘π΄ββ οΈ
+
+
+
+---
+
+# We do a lot of documentation
+
+## (as code)
+
+- 1 service catalog: the entry point
+- 174 services: technical documentation
+- 630 contributors
+
+
+
+---
+
+
+
+# Service catalog
+With [Hugo](https://gohugo.io/)
+
+
+---
+
+
+
+# Service documentation
+With [MkDocs](https://www.mkdocs.org/) +
+[material theme](https://squidfunk.github.io/mkdocs-material/)
+
+
+
+---
+
+
+
+
+---
+# π€―
+
+## DXC, Microsoft, GitHub, GitLab, AWS all use "Documentation as code"
+
+Because:
+
+- It's fast, secure and cheap (static sites)
+- It's easier to contribute to / keep up-to-date
+- It's battle tested
+- It's engineered
+- We can monitor it (think analytics)
+
+
+
+---
+
+# Our challenges
+
+- Common look & feel
+- Common voice
+- DRY: Don't Repeat Yourself
+- Diagrams: what changes?
+- Broken links
+- Publishing
+
+
+---
+
+
+
+
+---
+
+
+
+# CI and CD for documentation
+
+CI
+
+- Spell checking
+- Check for approved acronyms / custom dictionary
+- One voice
+- Periodically check for 404 links
+
+CD
+
+- Automate publishing
+
+
+
+---
+
+
+
+
+
+# In practice
+
+
+
+---
+
+# Authoring
+
+Leverage [`Markdown`](https://guides.github.com/features/mastering-markdown/)
+
+Use your favorite code editor:
+
+- [IntelliJ](https://www.jetbrains.com/help/idea/markdown.html#navigation)
+- [Eclipse](https://marketplace.eclipse.org/content/markdown-text-editor)
+- [VSCode](https://code.visualstudio.com/docs/languages/markdown) π
+
+
+
+---
+
+# Authoring (1)
+
+## Add editor extensions
+
+- [markdownlint](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint) (for syntax)
+- [Draw.io](https://marketplace.visualstudio.com/items?itemName=hediet.vscode-drawio) (for drawings)
+- [PlantUML](https://github.com/qjebbs/vscode-plantuml) (for diagrams as code)
+- [Marp](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode) (for slides)
+
+
+---
+
+
+# Authoring (2)
+
+## GitHub [Codespaces](https://github.com/features/codespaces) or GitPod
+
+- Edit directly from the browser
+- Make it easy for tech writers:
+ no `git clone/branch/push`
+ `git reset origin/main --hard`
+- Shared extensions across development environments
+
+
+---
+# Authoring (3)
+
+## Pick a tool
+
+- [Jekyll](https://jekyllrb.com/) π€
+- [Hugo](https://gohugo.io/): powerful, blazing fast π
+- [Marp](https://marp.app/): slides as code in markdown
+- [MkDocs](https://www.mkdocs.org/) + [material theme](https://squidfunk.github.io/mkdocs-material/) π
+
+
+---
+# Orchestrating
+
+- GitHub Actions
+- GitLab CI
+- Jenkins (`Jenkinsfile`) π
+- AWS code pipeline
+- Azure DevOps
+
+
+---
+# CI: Linter
+
+## CLI linter
+
+- [github super-linter](https://github.com/github/super-linter)
+- [markdownlint](https://github.com/DavidAnson/markdownlint)
+
+
+## Editor linter
+
+- [VS Code markdownlint extension](https://marketplace.visualstudio.com/items?itemName=DavidAnson.vscode-markdownlint)
+
+
+
+---
+# CI: Spell Checker
+
+## CLI spell checker
+
+
+
+- [spellcheck-github-actions](https://github.com/rojopolis/spellcheck-github-actions)
+- [spellchecker-cli](https://github.com/tbroadley/spellchecker-cli)
+
+## Editor spell checker
+
+- [VS Code code-spell-checker extension](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker)
+
+
+
+---
+# CI: Link checker
+
+
+
+## 404 links
+
+[markdown-link-check](https://github.com/tcort/markdown-link-check)
+
+
+---
+
+
+
+# CI: Testing (4)
+
+## Style / voice
+
+[Vale](https://github.com/errata-ai/vale)
+
+
+---
+# Publishing (CD)
+
+
+
+## GIT Hosting
+
+GitHub, GitLab, Bitbucket
+
+## Web hosting
+
+- [GitHub pages](https://pages.github.com/) π
+- [GitLab pages](https://docs.gitlab.com/ee/user/project/pages/)
+- [Netlify](https://www.netlify.com/)
+- An AWS S3 bucket π
+
+
+---
+
+# Quick starts
+
+Making it easy with:
+
+- [GitHub templates](https://docs.github.com/en/free-pro-team@latest/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)
+- [GitLab project templates](https://docs.gitlab.com/ee/gitlab-basics/create-project.html#project-templates)
+
+
+---
+# Thank you π
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy