From e5b9af8765d187cbf2eb2131b3f3dbde9e66f1ea Mon Sep 17 00:00:00 2001
From: Jorge <jorge.costa@developer.pt>
Date: Mon, 8 Oct 2018 16:28:34 +0100
Subject: [PATCH] Added docs.

---
 docs/block-api.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/docs/block-api.md b/docs/block-api.md
index 181d0c4b1129ad..b795b7f0793425 100644
--- a/docs/block-api.md
+++ b/docs/block-api.md
@@ -412,6 +412,19 @@ align: true,
 // Pick which alignment options to display.
 align: [ 'left', 'right', 'full' ],
 ```
+When supports align is used the block attributes definition is extended to include an align attribute with a string type.
+By default, no alignment is assigned to the block. 
+The block can apply a default alignment by specifying its own align attribute with a default e.g.:
+```
+attributes: {
+	...
+		align: {
+			type: 'string',
+			default: 'right'
+		},
+	...
+}
+```
 
 - `alignWide` (default `true`): This property allows to enable [wide alignment](../docs/extensibility/theme-support.md#wide-alignment) for your theme. To disable this behavior for a single block, set this flag to `false`.