diff --git a/doc/05-service-monitoring.md b/doc/05-service-monitoring.md
index d679fb652..54c24d0b1 100644
--- a/doc/05-service-monitoring.md
+++ b/doc/05-service-monitoring.md
@@ -438,8 +438,17 @@ Testcase 5: Transactions fine.
```
If the extended output shouldn't be visible in your monitoring, but only for testing,
-it is recommended to implement the `-v` or `--verbose` plugin parameter to allow
-developers and users to debug further.
+it is recommended to implement the `--verbose` plugin parameter to allow
+developers and users to debug further. Check [here](05-service-monitoring.md#service-monitoring-plugin-api-verbose)
+for more implementation tips.
+
+> **Tip**
+>
+> More debug output also helps when implementing your plugin.
+>
+> Best practice is to have the plugin parameter and handling implemented first,
+> then add it anywhere you want to see more, e.g. from initial database connections
+> to actual query results.
#### Status
@@ -508,9 +517,35 @@ __version__ = '0.9.1'
if __name__ == '__main__':
parser = argparse.ArgumentParser()
+
parser.add_argument('-V', '--version', action='version', version='%(prog)s v' + sys.modules[__name__].__version__)
```
+#### Verbose
+
+Plugins should provide a verbose mode with `-v` or `--verbose` in order
+to show more detailed log messages. This helps to debug and analyse the
+flow and execution steps inside the plugin.
+
+Ensure to add the parameter prior to implementing the check logic into
+the plugin.
+
+Example in Python taken from [check_tinkerforge](https://github.com/NETWAYS/check_tinkerforge/blob/master/check_tinkerforge.py):
+
+```
+import argparse
+import signal
+import sys
+
+if __name__ == '__main__':
+ parser = argparse.ArgumentParser()
+
+ parser.add_argument('-v', '--verbose', action='store_true')
+
+ if args.verbose:
+ print("Verbose debug output")
+```
+
### Create a new Plugin
Sometimes an existing plugin does not satisfy your requirements. You
@@ -582,6 +617,10 @@ The following examples should help you to start implementing your own ideas.
There is a variety of plugins available. This collection is not complete --
if you have any updates, please send a documentation patch upstream.
+Please visit our [community forum](https://community.icinga.com) which
+may provide an answer to your use case already. If not, do not hesitate
+to create a new topic.
+
### General Monitoring
If the remote service is available (via a network protocol and port),