diff --git a/modules/ROOT/pages/contributing-docs/asciidoc-markup.adoc b/modules/ROOT/pages/contributing-docs/asciidoc-markup.adoc
index 2326d14..3163a45 100644
--- a/modules/ROOT/pages/contributing-docs/asciidoc-markup.adoc
+++ b/modules/ROOT/pages/contributing-docs/asciidoc-markup.adoc
@@ -204,6 +204,51 @@ You can also alter the styling with the help of https://datatables.net/manual/st
 
 DataTables real usage can be seen on the xref:legal::not-allowed-licenses.adoc[Legal documentation].
 
+=== Tabs block
+
+You can create a set of tabs to organize documentation content in a block.
+
+.Example of defining a tab set
+[,asciidoc]
+----
+[tabs]
+====
+Tab A:: Contents of Tab A.
+
+Tab B::
++
+Contents of Tab B.
+
+Tab C::
++
+--
+Contents of Tab C.
+
+Contains more than one block.
+--
+====
+----
+
+.Resulting tab set 
+[tabs]
+====
+Tab A:: Contents of Tab A.
+
+Tab B::
++
+Contents of Tab B.
+
+Tab C::
++
+--
+Contents of Tab C.
+
+Contains more than one block.
+--
+====
+
+For more information about tabs, refer to the Asciidoctor Tabs extension at https://github.com/asciidoctor/asciidoctor-tabs.
+
 === Table of content
 A table of content is automatically generated on the right of each pages.