docs: clarify params server_url & site

README.md

@@ -108,6 +108,8 @@ We encourage you - in accordance with Ansible Best Practices -
 to always use FQCNs (Fully Qualified Collection Names) as seen below.
 This ensures, that you always know, which module is at play.
 
+Please keep in mind the parameters `server_url` and `site` are concatenated to form the base URL of the Checkmk site.
+
 ```yaml
 ---
 - hosts: all
@@ -123,6 +125,7 @@ This ensures, that you always know, which module is at play.
         sites:
           - "mysite"
 ```
+
 ## Getting Involved
 
 See [CONTRIBUTING](CONTRIBUTING.md).

plugins/doc_fragments/common.py

@@ -7,11 +7,11 @@ class ModuleDocFragment(object):
     DOCUMENTATION = r"""
     options:
         server_url:
-            description: The base url of your Checkmk server including the protocol.
+            description: The base url of your Checkmk server including the protocol but excluding the site.
             required: true
             type: str
         site:
-            description: The site you want to connect to.
+            description: The site you want to connect to. This will be appended to the server_url as part of the API request url.
             required: true
             type: str
         automation_user: