[brooklyn-docs] 02/03: address PR comments

[he...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

heneveld pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/brooklyn-docs.git

commit cde480ce4aa95d4cd599622e786e1ab009aa2a1d
Author: Alex Heneveld <al...@cloudsoftcorp.com>
AuthorDate: Wed Jun 2 10:11:38 2021 +0100

    address PR comments
---
 guide/blueprints/yaml-reference.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/guide/blueprints/yaml-reference.md b/guide/blueprints/yaml-reference.md
index 982cef0..f6f46e7 100644
--- a/guide/blueprints/yaml-reference.md
+++ b/guide/blueprints/yaml-reference.md
@@ -287,9 +287,10 @@ elements for more information:
 Some tags are used by convention and in the UI for special purposes.
 These are:
 
-* `ui-composer-annotation`: text (interpreted as markdown without HTML support) which will be displayed on a node in the blueprint composer,
+* `ui-composer-annotation`: text (interpreted as markdown without HTML support) which will be displayed on a node in the Blueprint Composer,
   or a map containing a key with the `text` and optionally any/all of `{x, y, width, height, background, style, styleInnerDiv}` for displaying it.
-For example:
+  The display of these can be toggled in the Blueprint Composer by selecting "Layers > Annotations".
+  This is illustrated in the following blueprint:
 
   ~~~ yaml
   name: Annotation Sample
@@ -302,7 +303,7 @@ For example:
             Shown below, yellow text, centered with CSS. Because it's long, scroll bars horizontally and vertically shown when
             needed.
           styleInnerDiv: 'margin: auto; color: yellow;'
-          'y': 120
+          y: 120
   - type: server
     brooklyn.tags:
       - ui-composer-annotation:
@@ -312,7 +313,7 @@ For example:
           width: 300
           height: 200
           x: 220
-          'y': 0
+          y: 0
           background: '#ffcccc'
           style: 'font-size: 9px;'
   ~~~