Signed-off-by: Sebastian Wagner <sebastian.wagner@suse.com>
=====================
As *Service Specification* is a data structure often represented as YAML
-to specify the deployment of services. For example::
+to specify the deployment of services. For example:
+
+.. code-block:: yaml
service_type: rgw
service_id: realm.zone
types do not require a ``service_id``
A service of type ``nfs`` requires a pool name and contain
-an optional namespace::
+an optional namespace:
+
+.. code-block:: yaml
service_type: nfs
- service_id: realm.zone
+ service_id: mynfs
placement:
hosts:
- host1
orch apply prometheus "host1 host2 host3"
-Or in yaml::
+Or in yaml:
+
+.. code-block:: yaml
service_type: prometheus
placement:
orch apply prometheus label:mylabel
-Or in yaml::
+Or in yaml:
+
+.. code-block:: yaml
service_type: prometheus
placement:
orch apply prometheus '*'
-Or in yaml::
+Or in yaml:
+
+.. code-block:: yaml
service_type: prometheus
placement:
orch apply prometheus "3 host1 host2"
-Or in yaml::
+Or in yaml:
+
+.. code-block:: yaml
service_type: prometheus
placement:
count: 3
-Or with hosts::
+Or with hosts:
+
+.. code-block:: yaml
service_type: prometheus
placement: