KNW-1343 - review done

thomaskoslowski · thomaskoslowski · commit 9f80115b2519 · 2024-02-26T14:22:35.000+01:00
diff --git a/src/common/de/basics_ackn.asciidoc b/src/common/de/basics_ackn.asciidoc
@@ -2,7 +2,7 @@
 // IGNORE Fußläufig
 include::global_attr.adoc[]
 = Quittierung von Problemen
-:revdate: 2024-02-19
+:revdate: 2024-02-26
 :title: Quittierung von Problemen - Neue Probleme von solchen in Bearbeitung unterscheiden
 :description: Probleme sind selten sofort behoben, sobald sie erkannt sind. Lernen Sie hier, wie Sie in {CMK} Probleme bestätigen und wie Sie Bestätigungen in der GUI finden.
 
@@ -13,6 +13,7 @@ xref:monitoring_basics#[Grundlagen des Monitorings mit {CMK}]
 {related-end}
 
 
+[#intro]
 == Einleitung
 
 {CMK} unterscheidet bei Problemen (also {DOWN}, {UNREACH}, {WARN}, {CRIT} oder {UNKNOWN}) zwei mögliche Zustände: *unbehandelt* und icon:icon_ack[] *bearbeitet*.
@@ -27,10 +28,11 @@ Wenn ein Problem quittiert ist, dann
 Ferner können Sie in Ansichten mit dem icon:icon_filter[alt="Symbol zur Anzeige der Filterleiste."] Filter [.guihint]#Problem acknowledged# gezielt nur quittierte oder unquittierte Probleme anzeigen lassen.
 
 
+[#procedure]
 == Ablauf einer Quittierung
 
 Probleme werden über xref:commands#[Kommandos] auf den betroffenen Hosts/Services quittiert.
-Über den gleichen Weg können sie Quittierungen auch wieder entfernen:
+Über den gleichen Weg können Sie Quittierungen auch wieder entfernen:
 
 image::basics_ackn_acknowledge.png[]
 
@@ -39,31 +41,37 @@ Hinweise zu den Optionen:
 [cols="30,~"]
 |===
 |[.guihint]#Comment# |Sie können an dieser Stelle auch eine URL in der Form `pass:[https://www.example.com]` eintragen, die dann als anklickbarer Link zur Verfügung steht.
-|[.guihint]#Expire on# |Kommerzielle Editionen: Mit dieser Option setzen Sie eine Gültigkeitsdauer für die Quittierung.  Nach dem Erreichen der eingestellten Zeit verschwindet die Quittierung von selbst, auch wenn der Host/Service nicht wieder auf {OK} bzw. {UP} geht.
-|[.guihint]#Ignore status changes until services/hosts are OK/UP again (sticky)# |Normalerweise gilt eine Quittierung immer nur bis zum *nächsten Zustandswechsel*. Wenn also z.B. ein Service im Zustand {WARN} quittiert wird und später nach {CRIT} wechselt, so wird die Quittierung automatisch entfernt. Durch das Einschalten von [.guihint]#sticky# bleibt die Quittierung solange erhalten, bis der Zustand {OK} bzw. {UP} erreicht wird.
-|[.guihint]#Keep comment after acknowledgment expires (persistent comment)# |Mit dieser Option wird Ihr Kommentar nicht automatisch gelöscht, wenn die Quittierung verschwindet oder entfernt wird. So erstellte Kommentare müssen Sie später manuell löschen (siehe am Ende dieses Kapitels).
-|[.guihint]#Notify affected users if notification rules are in place (send notifications)# |Löst Benachrichtigungen an alle Kontakte des Hosts/Services vom Typ [.guihint]#Acknowledgement of host/service problem# aus. So wissen Ihre Kollegen Bescheid.
+|[.guihint]#Expire on# |Kommerzielle Editionen: Mit dieser Option setzen Sie eine Gültigkeitsdauer für die Quittierung.
+Nach dem Erreichen der eingestellten Zeit verschwindet die Quittierung von selbst, auch wenn der Host/Service nicht wieder auf {OK} bzw. {UP} geht.
+|[.guihint]#Ignore status changes until services/hosts are OK/UP again (sticky)# |Normalerweise gilt eine Quittierung immer nur bis zum *nächsten Zustandswechsel*.
+Wenn also z.B. ein Service im Zustand {WARN} quittiert wird und später nach {CRIT} wechselt, so wird die Quittierung automatisch entfernt.
+Durch das Aktivieren dieser Option bleibt die Quittierung solange erhalten, bis der Zustand {OK} bzw. {UP} erreicht wird.
+|[.guihint]#Keep comment after acknowledgment expires (persistent comment)# |Mit dieser Option wird Ihr Kommentar nicht automatisch gelöscht, wenn die Quittierung verschwindet oder entfernt wird.
+So erstellte Kommentare müssen Sie später manuell löschen, wie im xref:gui[nächsten Kapitel] beschrieben.
+|[.guihint]#Notify affected users if notification rules are in place (send notifications)# |Löst Benachrichtigungen vom Typ `ACKNOWLEDGEMENT` an alle Kontakte des Hosts/Services aus.
+So wissen Ihre Kollegen Bescheid.
 |===
 
 Sie können die Voreinstellungen dieser Optionen dauerhaft über [.guihint]#Edit defaults# verändern.
-Fußläufig erreichen Sie diese Voreinstellung über [.guihint]#Setup > General > Global settings > User interface > Acknowledge problems#.
+Fußläufig erreichen Sie diese Voreinstellung über [.guihint]#Setup > General > Global settings > User interface > Acknowledge problems.#
 
+
+[#gui]
 == Quittierungen in der GUI
 
 In der {CMK}-Oberfläche gibt es mehrere Möglichkeiten, um Quittierungen anzuzeigen.
 
 In allen Ansichten von Host und Services werden quittierte Probleme durch zwei Symbole gekennzeichnet:
 
-[cols=2]
+[cols="30,~"]
 |===
 |icon:icon_ack[] |Dieses Symbol kennzeichnet die Quittierung.
 |icon:icon_comment[] |Wenn Sie dieses Symbol anklicken, dann wird die Liste mit Quittierungskommentaren angezeigt.
 |===
 
 Über [.guihint]#Monitor > Overview > Comments# gelangen Sie zur Liste aller Kommentare auf Hosts und Services -- darunter auch diejenigen, die durch Quittierungen entstanden sind.
 Kommentare können über xref:commands#[Kommandos] gelöscht werden.
-// SK: Der folgende Satz war womöglich ein Missverständnos oder eine unglücklioche Formulierung. Ich kommentiere ihn vorübergehend aus.
+// SK: Der folgende Satz war womöglich ein Missverständnos oder eine unglückliche Formulierung. Ich kommentiere ihn vorübergehend aus.
 // Das Löschen eines Kommentars hat keine Auswirkung auf gesetzte Quittierungen.
 
-[{image-border}]
 image::basics_ackn_comments.png[]
diff --git a/src/common/de/intro_monitor.asciidoc b/src/common/de/intro_monitor.asciidoc
@@ -2,7 +2,7 @@
 // IGNORE checkboxes
 include::global_attr.adoc[]
 = {CMK} im Monitoring
-:revdate: 2023-05-30
+:revdate: 2024-02-26
 :title: {CMK} im Monitoring
 :description: Probleme zu quittieren und Wartungszeiten einzurichten sind wichige Aufgaben im Monitoring mit {CMK}.
 
@@ -111,7 +111,7 @@ image::basics_downtimes_schedule.png[alt="Dialog zur Definition einer Wartungsze
 
 Bei den Wartungszeiten gibt es einen ganzen Haufen von Optionen.
 Einen Kommentar müssen Sie in jedem Fall eingeben.
-Für die Festlefgung des Zeitraums gibt es zahlreiche unterschiedliche Möglichkeiten -- vom einfachen
+Für die Festlegung des Zeitraums gibt es zahlreiche unterschiedliche Möglichkeiten -- vom einfachen
 [.guihint]#2 hours#, welches die Wartung *ab sofort* definiert, bis hin zu der
 Angabe eines expliziten Zeitraums, mit dem auch eine Wartung in der Zukunft
 definiert werden kann.
diff --git a/src/common/en/basics_ackn.asciidoc b/src/common/en/basics_ackn.asciidoc
@@ -2,7 +2,7 @@
 // IGNORE
 include::global_attr.adoc[]
 = Acknowledging problems
-:revdate: 2024-02-19
+:revdate: 2024-02-26
 :title: Acknowledging problems - Distinguishing new problems from those in progress
 :description: Problems are rarely fixed as soon as they are detected. Learn here how to acknowledge problems in {CMK} and how to find acknowledgements in the GUI.
 
@@ -13,21 +13,23 @@ xref:monitoring_basics#[Basic principles of monitoring with {CMK}]
 {related-end}
 
 
+[#intro]
 == Introduction
 
 For the problems {DOWN}, {UNREACH}, {WARN}, {CRIT} or {UNKNOWN} {CMK} distinguishes two possible states: *unhandled* and icon:icon_ack[] *handled*.
 A handled (acknowledged) problem indicates that the issue is known and that somebody is attending to it.
 
 If a problem has been acknowledged, then...
 
-* ... it will be identified with a icon:icon_ack[] symbol,
+* ... it will be identified with a icon:icon_ack[] icon,
 * ... it will no longer appear as [.guihint]#Unhandled# in the xref:user_interface#overview[Overview] snap-in,
 * ... no further xref:notifications#[notifications] will be sent.
 
 Additionally, problems can be systematically identified in views as being acknowledged or unacknowledged via the icon:icon_filter[alt="Icon for displaying the filter bar."] filter [.guihint]#Problem acknowledged#.
 
 
-== The Acknowledgement procedure
+[#procedure]
+== The acknowledgement procedure
 
 Problems are acknowledged via xref:commands#[commands] on the affected hosts/services.
 Acknowledgements can be removed in the same way.
@@ -39,34 +41,36 @@ Advice for these options:
 [cols="30,~"]
 |===
 |[.guihint]#Comment# |You can include a URL such as `pass:[https://www.example.com]` in this field, which will be replaced by a clickable link.
-|[.guihint]#Expire on# |Commercial editions: With this option you can set a validity period for the acknowledgement. Once the set time has been reached, the acknowledgement is automatically deleted, even if the host/service does not go back to {OK} or {UP}.
-|[.guihint]#Ignore status changes until services/hosts are OK/UP again (sticky)# |An acknowledgement is normally valid until the *next status change*. If for example, a service has been acknowledged with a {WARN} status, and later changes to {CRIT}, the acknowledgement will be automatically-removed. Activating [.guihint]#sticky# will retain the acknowledgement until an {OK} or an {UP} status is received.
-|[.guihint]#Keep comment after acknowledgment expires (persistent comment)# |With this option your commentary will not be automatically deleted if the acknowledgement disappears or is removed. Commentaries entered in this way must be manually deleted later (see the end of this chapter).
-|[.guihint]#Notify affected users if notification rules are in place (send notifications)# |All contacts assigned to the host/service whom are configured to be notified for the [.guihint]#Acknowledgement of host/service problem# will be sent a notification.
+|[.guihint]#Expire on# |Commercial editions: With this option you can set a validity period for the acknowledgement.
+When the specified time has been reached, the acknowledgement is automatically deleted, even if the host/service does not go back to {OK} or {UP}.
+|[.guihint]#Ignore status changes until services/hosts are OK/UP again (sticky)# |An acknowledgement is normally valid until the *next   change*.
+If for example, a service has been acknowledged with a {WARN} status, and later changes to {CRIT}, the acknowledgement will be automatically-removed.
+Activating this option will retain the acknowledgement until the {OK} or {UP} status is reached.
+|[.guihint]#Keep comment after acknowledgment expires (persistent comment)# |With this option your comment will not be automatically deleted if the acknowledgement disappears or is removed.
+Comments created in this way must be deleted manually later as described in the xref:gui[next chapter].
+|[.guihint]#Notify affected users if notification rules are in place (send notifications)# |Triggers notifications of type `ACKNOWLEDGEMENT` to all contacts of the host/service .
+So your colleagues know about it.
 |===
 
 You can permanently change the default settings for these options via [.guihint]#Edit defaults#.
 These settings are also available via [.guihint]#Setup > General > Global settings > User interface > Acknowledge problems#.
 
 
+[#gui]
 == Acknowledgements in the GUI
 
-In the {CMK} web interface there are several possibilities for displaying
-acknowledgements.
+In the {CMK} web interface there are several possibilities for displaying acknowledgements.
 
-In all host and service views, acknowledged problems are identified by
-two symbols:
+In all host and service views, acknowledged problems are identified by two icons:
 
-[cols=2]
+[cols="30,~"]
 |===
-|icon:icon_ack[] |This symbol identifies an acknowledgement
-|icon:icon_comment[] |Clicking on this symbol displays a list with any acknowledgement comments.
+|icon:icon_ack[] |This icon identifies an acknowledgement
+|icon:icon_comment[] |Clicking on this icon displays a list with any acknowledgement comments.
 |===
 
 Via [.guihint]#Monitor > Overview > Comments# you can view a list of all comments for hosts and services -- including those created through acknowledgements.
 Comments may be deleted with xref:commands#[commands].
-// SK: The following sentence might have just been a misunderstanding or unfortunate wording. I will remove it for the time being.
 // Deleting a comment has no effect on logged acknowledgements.
 
-[{image-border}]
 image::basics_ackn_comments.png[]
diff --git a/src/common/en/intro_monitor.asciidoc b/src/common/en/intro_monitor.asciidoc
@@ -2,7 +2,7 @@
 // IGNORE 
 include::global_attr.adoc[]
 = {CMK} in monitoring
-:revdate: 2023-05-30
+:revdate: 2024-02-26
 :title: {CMK} in monitoring
 :description: Acknowledging problems and setting up scheduled downtimes are important tasks in monitoring with {CMK}.
 
