diff --git a/.github/styles/vocab.txt b/.github/styles/vocab.txt
index a0841fe7d0..7f889392ac 100644
--- a/.github/styles/vocab.txt
+++ b/.github/styles/vocab.txt
@@ -230,3 +230,4 @@ yaml
Zalando
Zhou
Zolotusky
+zoomable
diff --git a/docs/features/techdocs/architecture.md b/docs/features/techdocs/architecture.md
index 01497b31bc..f502b3836e 100644
--- a/docs/features/techdocs/architecture.md
+++ b/docs/features/techdocs/architecture.md
@@ -9,7 +9,7 @@ description: Documentation on TechDocs Architecture
When you deploy Backstage (with TechDocs enabled by default), you get a basic
out-of-the box experience.
-
+
> Note: See below for our recommended deployment architecture which takes care
> of stability, scalability and speed.
@@ -43,7 +43,7 @@ channel to talk about it.
This is how we recommend deploying TechDocs in production environment.
-
+
The key difference in the recommended deployment approach is where the docs are
built.
diff --git a/microsite/README.md b/microsite/README.md
index d244caa22a..9589def3e3 100644
--- a/microsite/README.md
+++ b/microsite/README.md
@@ -204,3 +204,8 @@ For more information about custom pages, click [here](https://docusaurus.io/docs
# Full Documentation
Full documentation can be found on the [website](https://docusaurus.io/).
+
+## Additional notes
+
+- If you want to make images zoomable on click, add the `data-zoomable` attribute to your `img` element.
+ - In a docs or blog `.md` file, convert `` syntax to `
`
diff --git a/microsite/siteConfig.js b/microsite/siteConfig.js
index 6e8f8edddf..517cac2496 100644
--- a/microsite/siteConfig.js
+++ b/microsite/siteConfig.js
@@ -86,7 +86,11 @@ const siteConfig = {
},
// Add custom scripts here that would be placed in