docs: demo page

Author: alandefreitas

docs/modules/ROOT/nav.adoc

@@ -1,4 +1,5 @@
 * xref:index.adoc[]
+* xref:demos.adoc[]
 * xref:install.adoc[]
 * xref:usage.adoc[]
 * xref:config-file.adoc[]

docs/modules/ROOT/pages/demos.adoc

@@ -0,0 +1,28 @@
+= Demos
+
+A few examples of reference documentation generated with MrDocs are available in https://mrdocs.com/demos/:
+
+|===
+|  4+| *Multi-Page* 4+| *Single-Page*
+| *Library* | *Asciidoc* | *Rendered Asciidoc* | *HTML* | *XML* | *Asciidoc* | *Rendered Asciidoc* | *HTML* | *XML*
+
+| https://github.com/boostorg/url[Boost.URL]
+| https://mrdocs.com/demos/develop/boost-url/multi/adoc/[🔗]
+| https://mrdocs.com/demos/develop/boost-url/multi/adoc-asciidoc/[🔗]
+| https://mrdocs.com/demos/develop/boost-url/multi/html/[🔗]
+| https://mrdocs.com/demos/develop/boost-url/multi/xml/[🔗]
+| https://mrdocs.com/demos/develop/boost-url/single/adoc/[🔗]
+| https://mrdocs.com/demos/develop/boost-url/single/adoc-asciidoc/[🔗]
+| https://mrdocs.com/demos/develop/boost-url/single/html/[🔗]
+| https://mrdocs.com/demos/develop/boost-url/single/xml/[🔗]
+
+| https://github.com/boostorg/scope[Boost.Scope]
+| https://mrdocs.com/demos/develop/boost-scope/multi/adoc/[🔗]
+| https://mrdocs.com/demos/develop/boost-scope/multi/adoc-asciidoc/[🔗]
+|
+|
+| https://mrdocs.com/demos/develop/boost-scope/single/adoc/[🔗]
+| https://mrdocs.com/demos/develop/boost-scope/single/adoc-asciidoc/[🔗]
+|
+|
+|===

docs/modules/ROOT/pages/usage.adoc

@@ -65,10 +65,6 @@ At this step, you can also add any other flags you want to pass to `cmake`, such
 By running CMake with the `CMAKE_EXPORT_COMPILE_COMMANDS` flag, you will generate a `compile_commands.json` file in your build directory.
 This file contains all the information mrdocs needs to generate the documentation.
 
-== Demos
-
-A few examples of reference documentation generated with MrDocs are available in https://mrdocs.com/demos/.
-
 == MrDocs configuration file
 
 The `mrdocs.yml` configuration file contains information about the project that is not available in the `compile_commands.json` file or from the command line.