docs: Add deprecation note to 1.x documentation page

Dynatrace · Nov 9, 2023 · 3af9cd4 · 3af9cd4
1 parent bd55928
commit 3af9cd4
Show file tree

Hide file tree

Showing 6 changed files with 66 additions and 5 deletions.
diff --git a/documentation/README.md b/documentation/README.md
@@ -61,4 +61,11 @@ Example:
 ```
 
 2. Delete the versioned docs directory. Example: `documentation/versioned_docs/version-1.8.0`.
-3. Delete the versioned sidebars file. Example: `documentation/versioned_sidebars/version-1.8.0-sidebars.json`.
+3. Delete the versioned sidebars file. Example: `documentation/versioned_sidebars/version-1.8.0-sidebars.json`.
+
+
+# Build and view docs locally
+
+1. Install yarn
+2. Run `yarn install` to install [docusaurus](https://docusaurus.io/)
+3. Run `yarn start` to build and serve the documentation page locally
diff --git a/documentation/docs/documentation.md b/documentation/docs/documentation.md
@@ -5,7 +5,17 @@ title: Monaco Documentation
 slug: /
 ---
 
-# Welcome to the Monaco docs
+# Welcome to the Documentation for Monaco 1.x
+
+:::caution
+**Monaco 1.x is deprecated by Monaco 2.x since April 2023.**
+
+**This documentation only exists for reference purposes. We strongly suggest you upgrade!**
+
+Take a look at [the current documentation](https://docs.dynatrace.com/docs/shortlink/configuration-as-code)!
+
+Or jump directly into [the step-by-step migration guide](https://docs.dynatrace.com/docs/shortlink/configuration-as-code-migrate-to-v2)
+:::
 
 <p>
 Monaco is a "configuration as code" tool that allows you to create, update and version your observaiblity and security configurations in Dynatrace efficiently and at scale.

diff --git a/documentation/versioned_docs/version-1.5.3/intro.md b/documentation/versioned_docs/version-1.5.3/intro.md
@@ -5,6 +5,18 @@ title: What is Monaco?
 slug: /
 ---
 
+# Welcome to the Documentation for Monaco 1.5.x
+
+:::caution
+**Monaco 1.x is deprecated by Monaco 2.x since April 2023.**
+
+**This documentation only exists for reference purposes. We strongly suggest you upgrade!**
+
+Take a look at [the current documentation](https://docs.dynatrace.com/docs/shortlink/configuration-as-code)!
+
+Or jump directly into [the step-by-step migration guide](https://docs.dynatrace.com/docs/shortlink/configuration-as-code-migrate-to-v2)
+:::
+
 Monaco is CLI tool that tool automates deployment of Dynatrace Monitoring Configuration to one or multiple Dynatrace environments.
 
 ## Why monaco?

diff --git a/documentation/versioned_docs/version-1.6.0/intro.md b/documentation/versioned_docs/version-1.6.0/intro.md
@@ -5,6 +5,18 @@ title: What is Monaco?
 slug: /
 ---
 
+# Welcome to the Documentation for Monaco 1.6.x
+
+:::caution
+**Monaco 1.x is deprecated by Monaco 2.x since April 2023.**
+
+**This documentation only exists for reference purposes. We strongly suggest you upgrade!**
+
+Take a look at [the current documentation](https://docs.dynatrace.com/docs/shortlink/configuration-as-code)!
+
+Or jump directly into [the step-by-step migration guide](https://docs.dynatrace.com/docs/shortlink/configuration-as-code-migrate-to-v2)
+:::
+
 Monaco is CLI tool that automates deployment of Dynatrace Monitoring Configuration to one or multiple Dynatrace environments.
 
 ## Why monaco?

diff --git a/documentation/versioned_docs/version-1.7.0/documentation.md b/documentation/versioned_docs/version-1.7.0/documentation.md
@@ -5,7 +5,17 @@ title: Monaco Documentation
 slug: /
 ---
 
-# Welcome to the Monaco docs
+# Welcome to the Documentation for Monaco 1.7.x
+
+:::caution
+**Monaco 1.x is deprecated by Monaco 2.x since April 2023.**
+
+**This documentation only exists for reference purposes. We strongly suggest you upgrade!**
+
+Take a look at [the current documentation](https://docs.dynatrace.com/docs/shortlink/configuration-as-code)!
+
+Or jump directly into [the step-by-step migration guide](https://docs.dynatrace.com/docs/shortlink/configuration-as-code-migrate-to-v2)
+:::
 
 <p>
 Monaco is a monitoring as code (MAC) tool that allows you to create, update and version your monitoring configurations in Dynatrace efficiently and at scale.
@@ -109,4 +119,4 @@ Monaco is a monitoring as code (MAC) tool that allows you to create, update and
   </div>
 
 
-</div>
+</div>
diff --git a/documentation/versioned_docs/version-1.8.x/documentation.md b/documentation/versioned_docs/version-1.8.x/documentation.md
@@ -5,7 +5,17 @@ title: Monaco Documentation
 slug: /
 ---
 
-# Welcome to the Monaco docs
+# Welcome to the Documentation for Monaco 1.8.x
+
+:::caution
+**Monaco 1.x is deprecated by Monaco 2.x since April 2023.**
+
+**This documentation only exists for reference purposes. We strongly suggest you upgrade!**
+
+Take a look at [the current documentation](https://docs.dynatrace.com/docs/shortlink/configuration-as-code)!
+
+Or jump directly into [the step-by-step migration guide](https://docs.dynatrace.com/docs/shortlink/configuration-as-code-migrate-to-v2)
+:::
 
 <p>
 Monaco is a configuration as code tool that allows you to create, update and version your observability and security configurations in Dynatrace efficiently and at scale. Initially the focus was on "monitoring as code" hence the name Monaco.