From edcefba74a63a4060a4cb7eaeded2c1b79af9f90 Mon Sep 17 00:00:00 2001
From: mmitoraj <malgorzata.swieca@sap.com>
Date: Thu, 24 Oct 2024 09:14:58 +0200
Subject: [PATCH] Apply review suggestions

---
 docs/operator/README.md                    |  2 +-
 docs/operator/cn/01-10-installation.md     |  4 +++-
 docs/operator/cn/03-10-operations.md       | 14 +++++++++++++-
 docs/operator/ns2/01-10-installation.md    |  4 +++-
 docs/operator/ns2/03-10-operations.md      | 14 +++++++++++++-
 docs/operator/ns2/04-10-troubleshooting.md |  2 +-
 docs/operator/ns2/README.md                |  2 +-
 7 files changed, 35 insertions(+), 7 deletions(-)

diff --git a/docs/operator/README.md b/docs/operator/README.md
index 35cd335..d5f98a3 100644
--- a/docs/operator/README.md
+++ b/docs/operator/README.md
@@ -1 +1 @@
-This folder is mandatory only if your module/component is delivered to restricted markets.It includes documentation relevant to the respective operators.
\ No newline at end of file
+This folder is mandatory only if your module/component is delivered to restricted markets. It includes documentation relevant to the respective operators.
\ No newline at end of file
diff --git a/docs/operator/cn/01-10-installation.md b/docs/operator/cn/01-10-installation.md
index fa8d5ae..5216984 100644
--- a/docs/operator/cn/01-10-installation.md
+++ b/docs/operator/cn/01-10-installation.md
@@ -2,7 +2,9 @@
 
 ## Prerequisites
 
-<!--Describe the prerequisites for installing your service (if there are some).-->
+<!--Describe the prerequisites for installing your service (if there are some). For example:
+- List the components that your component depends on
+- List the BTP integrations used by your component-->
 
 ## Procedure
 
diff --git a/docs/operator/cn/03-10-operations.md b/docs/operator/cn/03-10-operations.md
index 4dca380..74efcb6 100644
--- a/docs/operator/cn/03-10-operations.md
+++ b/docs/operator/cn/03-10-operations.md
@@ -1,5 +1,17 @@
 # {Component/Service Name} - Operations
 
-<!--Please create only one single document for your Operations documentation. Our goal is to display all Operations content for a service on a single page so that the operators can quickly search for information using the search function.-->
+<!--Please create only one single document with multiple sections for your Operations documentation. Our goal is to display all Operations content for a service on a single page so that the operators can quickly search for information using the search function.-->
+
+<!--Recommended sections:
+
+## REST API {if applicable}
+
+## Custom Resources
+
+In this section, describe:
+- The component's CRs and their purpose
+- CRs' backup requirements (Is it regenerated or does it require backup?)
+- CRs' mechanics
+- CRs' labels and annotations -->
 
 <!--For more information, see [Documentation Guidelines for Operator Documentation](https://wiki.one.int.sap/wiki/display/NDW/Documentation+Guidelines+for+Operator+Documentation#DocumentationGuidelinesforOperatorDocumentation-OperationsDocumentation)-->
\ No newline at end of file
diff --git a/docs/operator/ns2/01-10-installation.md b/docs/operator/ns2/01-10-installation.md
index fa8d5ae..5216984 100644
--- a/docs/operator/ns2/01-10-installation.md
+++ b/docs/operator/ns2/01-10-installation.md
@@ -2,7 +2,9 @@
 
 ## Prerequisites
 
-<!--Describe the prerequisites for installing your service (if there are some).-->
+<!--Describe the prerequisites for installing your service (if there are some). For example:
+- List the components that your component depends on
+- List the BTP integrations used by your component-->
 
 ## Procedure
 
diff --git a/docs/operator/ns2/03-10-operations.md b/docs/operator/ns2/03-10-operations.md
index 4dca380..74efcb6 100644
--- a/docs/operator/ns2/03-10-operations.md
+++ b/docs/operator/ns2/03-10-operations.md
@@ -1,5 +1,17 @@
 # {Component/Service Name} - Operations
 
-<!--Please create only one single document for your Operations documentation. Our goal is to display all Operations content for a service on a single page so that the operators can quickly search for information using the search function.-->
+<!--Please create only one single document with multiple sections for your Operations documentation. Our goal is to display all Operations content for a service on a single page so that the operators can quickly search for information using the search function.-->
+
+<!--Recommended sections:
+
+## REST API {if applicable}
+
+## Custom Resources
+
+In this section, describe:
+- The component's CRs and their purpose
+- CRs' backup requirements (Is it regenerated or does it require backup?)
+- CRs' mechanics
+- CRs' labels and annotations -->
 
 <!--For more information, see [Documentation Guidelines for Operator Documentation](https://wiki.one.int.sap/wiki/display/NDW/Documentation+Guidelines+for+Operator+Documentation#DocumentationGuidelinesforOperatorDocumentation-OperationsDocumentation)-->
\ No newline at end of file
diff --git a/docs/operator/ns2/04-10-troubleshooting.md b/docs/operator/ns2/04-10-troubleshooting.md
index f32d418..b01811e 100644
--- a/docs/operator/ns2/04-10-troubleshooting.md
+++ b/docs/operator/ns2/04-10-troubleshooting.md
@@ -3,6 +3,6 @@
 <!--
 - Use a problem-solution format, where a problem can be presented as a statement or a question.
 - If you have multiple solutions, provide the recommended solution first.
--  Provide all recommended actions and introduce a connection to the alerts of your service, preferably the monitor name.-->
+- Provide all recommended actions and introduce a connection to the alerts of your service, preferably the monitor name.-->
 
 <!--For more information, see [Documentation Guidelines for Troubleshooting Documentation](https://wiki.one.int.sap/wiki/display/NDW/Documentation+Guidelines+for+Operator+Documentation#DocumentationGuidelinesforOperatorDocumentation-TroubleshootingDocumentation)-->
diff --git a/docs/operator/ns2/README.md b/docs/operator/ns2/README.md
index 43b8aec..ef39595 100644
--- a/docs/operator/ns2/README.md
+++ b/docs/operator/ns2/README.md
@@ -1,4 +1,4 @@
-This folder includes documentation relevant for the NS2 operator. The documentation is published as part of the [SAP BTP, Partner-Managed Edition (AWS GovCloud)](https://help.sap.com/docs/OPSAWS?state=DRAFT) official documentation in the SAP Help Portal
+This folder includes documentation relevant to the NS2 operator. The documentation is published as part of the [SAP BTP, Partner-Managed Edition (AWS GovCloud)](https://help.sap.com/docs/OPSAWS?state=DRAFT) official documentation in the SAP Help Portal
 
 The mandatory documentation types include: