Fixes 705 - Remove superflous include snippets

Author: ralf401

admin/console-rails-shell.include.rst

@@ -3,7 +3,14 @@ Generic CTI
 
 This page describes the generic CTI API scopes and functionalities.
 
-.. include:: /api/generic-cti/cti-endpoint-limitations.include.rst
+.. warning:: **🚧 Limitations / Notes 🚧**
+
+   * Authentication on this endpoint works fundamentally different compared to
+     the rest of the API.
+   * API clients *do not* work with the CTI endpoints unless explicitly stated
+     by the client vendor!
+   * The CTI endpoints are relevant for PBX systems only.
+
 
 Features
    Here's a small condensed list of the possibilities this CTI API provides.

api/generic-cti/cti-endpoint-limitations.include.rst

@@ -28,7 +28,68 @@ Preparation
 Install PostgreSQL
 ^^^^^^^^^^^^^^^^^^
 
-.. include:: /install/includes/postgres-installation.rst
+.. tabs::
+
+   .. tab:: Ubuntu / Debian
+
+      .. code-block:: console
+
+         $ sudo apt update
+
+      .. code-block:: console
+
+         $ sudo apt install postgresql postgresql-contrib
+
+      .. code-block:: console
+
+         $ sudo systemctl start postgresql
+
+      .. code-block:: console
+
+         $ sudo systemctl enable postgresql
+
+   .. tab:: CentOS
+
+      .. code-block:: console
+
+         $ sudo yum install postgresql-server postgresql-contrib
+
+      .. code-block:: console
+
+         $ sudo postgresql-setup initdb
+
+      .. code-block:: console
+
+         $ sudo systemctl start postgresql
+
+
+      .. code-block:: console
+
+         $ sudo systemctl enable postgresql
+
+   .. tab:: OpenSUSE / SLES
+
+      .. code-block:: console
+
+         $ sudo zypper refresh
+
+      .. code-block:: console
+
+         $ sudo zypper install postgresql postgresql-server postgresql-contrib
+
+      openSuSE 15 also requires:
+
+      .. code-block:: console
+
+         $ sudo zypper install postgresql-server-devel
+
+      .. code-block:: console
+
+         $ sudo systemctl start postgresql
+
+      .. code-block:: console
+
+         $ sudo systemctl enable postgresql
 
 Please also have a look at :doc:`/appendix/configure-database-server`.
 
@@ -95,8 +156,13 @@ Database Credentials
 Adjust the configuration file to fill in the credentials for your new
 PostgreSQL server. Use ``postgresql`` as ``adapter``.
 
+.. tip::
+
+   **🤓 For easiest usage ...**
 
-.. include:: /install/includes/postgres-permissions.rst
+   If you provide your Zammad user with database creation permission, you can
+   run ``db:create`` in the following section. If you don't want that, you'll
+   have to create the database manually.
 
 Create Empty Database
 ^^^^^^^^^^^^^^^^^^^^^

api/generic-cti/index.rst

@@ -18,14 +18,25 @@ This guide will discuss how to set up third party reporting tools with Zammad.
       also check :admin-docs:`the Elasticsearch integration </system/integrations/elasticsearch.html>`
       page for information on how to hook your tool to the index.
 
-.. include:: reporting-tools-thirdparty/include-limitations.rst
+.. note:: **🚧 Limitations 🚧**
+
+   Please note that this guide expects all requirements to be up and running.
+   We will not cover core configurations of each tool. Please also note that
+   we can't support you with configuration of your specific third party tool.
+
+   **🤓 Specific use cases**
+
+   You may have specific use cases which we can't cover in this documentation.
+   The following sub pages and also our
+   :doc:`/install/elasticsearch/indexed-attributes` should provide enough
+   information to help you!
 
 Getting Started
 ---------------
 
 You will need
 
-   * A instance of the reporting tool of your choice (hosted or self-hosted)
+   * An instance of the reporting tool of your choice (hosted or self-hosted)
 
 .. include:: reporting-tools-thirdparty/include-requirements.rst
 

appendix/migrate-to-postgresql.rst

@@ -9,7 +9,18 @@ installation stores within the Elasticsearch indexes.
    :width: 90%
    :align: center
 
-.. include:: include-limitations.rst
+.. note:: **🚧 Limitations 🚧**
+
+   Please note that this guide expects all requirements to be up and running.
+   We will not cover core configurations of each tool. Please also note that
+   we can't support you with configuration of your specific third party tool.
+
+   **🤓 Specific use cases**
+
+   You may have specific use cases which we can't cover in this documentation.
+   The following sub pages and also our
+   :doc:`/install/elasticsearch/indexed-attributes` should provide enough
+   information to help you!
 
 Overview
 --------