diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index 7338daf..fcd1adf 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -90,7 +90,7 @@ jobs:
- linkcheck
- StyleCheck
env:
- MARP_VERSION: 0.21.1
+ MARP_VERSION: 1.4.2
steps:
# Checks out a copy of your repository on the ubuntu-latest machine
# https://github.com/actions/checkout
@@ -101,13 +101,14 @@ jobs:
token: ${{ github.token }}
# Runs the website build
- - run: sudo wget -qO- https://github.com/marp-team/marp-cli/releases/download/v0.21.1/marp-cli-v$MARP_VERSION-linux.tar.gz | tar xvz
+ - run: sudo wget -qO- https://github.com/marp-team/marp-cli/releases/download/v$MARP_VERSION/marp-cli-v$MARP_VERSION-linux.tar.gz | tar xvz
- run: chmod +x marp && export PATH=$PATH:$(pwd) && mkdir site && marp slides/README.md --html -o site/index.html
+ - run: cp slides/* site
# https://github.com/actions/upload-artifact
- uses: actions/upload-artifact@v2
with:
name: slides
- path: site/index.html
+ path: site/*
#https://github.com/marketplace/actions/deploy-to-github-pages
- name: Deploy to GitHub Pages
diff --git a/.ignoredWords.txt b/.ignoredWords.txt
index dec97ce..9bc1e50 100644
--- a/.ignoredWords.txt
+++ b/.ignoredWords.txt
@@ -16,6 +16,7 @@ contributeurs
cron
dev
DevOps
+DocAsCode
documentation-as-code.github.io
docx
Don't
@@ -31,7 +32,7 @@ GIT
github
GitHub
GitLab
-GitPod
+Gitpod
gource
Grenoble
https
@@ -73,13 +74,18 @@ pptx
project
px
shortcodes
+sli.dev
spellcheck-github-actions
spellchecker-cli
+SRE
+Sr
super-linter
+Technology
templates
theme
url
Vale
vscode
+vscode.dev
VSCode
web
diff --git a/brainstorm.drawio.png b/brainstorm.drawio.png
index 56fa80a..6f95fdb 100644
Binary files a/brainstorm.drawio.png and b/brainstorm.drawio.png differ
diff --git a/slides/README.md b/slides/README.md
index a3130be..6cf26ef 100644
--- a/slides/README.md
+++ b/slides/README.md
@@ -26,6 +26,10 @@ style: |
color: white;
}
+ section table {
+ border-style : hidden!important;
+ }
+
footer: '[github/ojacques](https://github.com/ojacques) [github/angegar](https://github.com/angegar)'
@@ -55,9 +59,13 @@ Hello I am Laurent, I also work for DXC Technology where I am acting internally
---
-
+
+
+
-Documentation : La quête de la perfection
+---
+
+# Documentation : La quête de la perfection
# 🏰🦄🤴👸🐴👻⚔🗡🏴☠️
@@ -111,7 +119,7 @@ The context for the experience report is our own company (but we do that with ou
---
-
+
# Catalogue de service
@@ -129,7 +137,7 @@ Service catalog:
-->
---
-
+
# Documentation de service
Avec [MkDocs](https://www.mkdocs.org/) +
@@ -144,7 +152,7 @@ The documentation for each service leverages Mkdocs which we love because it's v
---
-
+
---
-
+
-
+
@@ -242,7 +250,7 @@ Let's start with the development environment, which environment is required ?
-->
---
-
+
# Création de contenu
Utilisation de [`Markdown`](https://guides.github.com/features/mastering-markdown/)
@@ -250,7 +258,7 @@ Utilisation de [`Markdown`](https://guides.github.com/features/mastering-markdow
Avec votre éditeur préféré :
- [IntelliJ](https://www.jetbrains.com/help/idea/markdown.html#navigation)
-- [Eclipse](https://marketplace.eclipse.org/content/markdown-text-editor)
+- Eclipse
- [VSCode](https://code.visualstudio.com/docs/languages/markdown) 👈
---
-
+
# Création (2)
-## GitHub [Codespaces](https://github.com/features/codespaces) ou GitPod
+## [Codespaces](https://github.com/features/codespaces), [vscode.dev](https://vscode.dev/), [Gitpod](https://www.gitpod.io)
- Édition directe dans le navigateur
- Plus facile pour les éditeurs techniques:
@@ -303,7 +311,7 @@ GitHub offers an online VSCode instance attached to your GitHub repository. The
- [Jekyll](https://jekyllrb.com/) 🤐
- [Hugo](https://gohugo.io/): puissant, léger, rapide 👈
-- [Marp](https://marp.app/): transparents / présentations
+- [Marp](https://marp.app/), [sli.dev](https://sli.dev): transparents / présentations
- [MkDocs](https://www.mkdocs.org/) + [material theme](https://squidfunk.github.io/mkdocs-material/) 👈
---
-
+
# CI: Tester (4)
@@ -417,7 +425,7 @@ Used to ensure your a vocabulary style guide.
---
# Publication (CD)
-
+
## Hébergement GIT
@@ -435,7 +443,7 @@ GitHub, GitLab, Bitbucket
You don't have to spin up a virtual machine or server to host your documentation site. Major Source Code Management applications already host web pages.
-->
---
-
+
# Démarrage rapide
Facilitez vous la vie avec les :
@@ -449,8 +457,17 @@ Speaker: Laurent
We have been using GitHub template to ease the creation of Documentation As Code
-->
+
+---
+
+# DocAsCode VS Confluence
+
+
+
---
# Questions / réponses
---
# Merci 🙏
+
+
diff --git a/slides/compare_daas_confluence.png b/slides/compare_daas_confluence.png
new file mode 100644
index 0000000..6d1675f
Binary files /dev/null and b/slides/compare_daas_confluence.png differ
diff --git a/slides/faces.drawio.png b/slides/faces.drawio.png
new file mode 100644
index 0000000..c3ea721
Binary files /dev/null and b/slides/faces.drawio.png differ
diff --git a/slides/qr-slides.jpg b/slides/qr-slides.jpg
new file mode 100644
index 0000000..e4d83c7
Binary files /dev/null and b/slides/qr-slides.jpg differ
diff --git a/slides/slide-background.drawio.png b/slides/slide-background.drawio.png
new file mode 100644
index 0000000..3bf3ba1
Binary files /dev/null and b/slides/slide-background.drawio.png differ