Add documentation to master branch

Change-Id: I2504bb10f1ae73ec0cbc08b7ba5a88925caa1674

1 files changed, 27 insertions, 0 deletions

diff --git a/documentation/portal/portal-overview.asciidoc b/documentation/portal/portal-overview.asciidoc
new file mode 100644
index 0000000000..8368de1fe2
--- /dev/null
+++ b/documentation/portal/portal-overview.asciidoc
@@ -0,0 +1,27 @@
+---
+title: Overview
+order: 1
+layout: page
+---
+
+[[portal.overview]]
+= Overview
+
+Vaadin supports running UIs as portlets in a portal, as defined in the JSR-286
+(Java Portlet API 2.0) standard. A portlet UI is defined just as a regular UI,
+but deploying to a portal is somewhat different from deployment of regular web
+applications, requiring special portlet descriptors, etc. Creating the portlet
+project with the Vaadin Plugin for Eclipse or a Maven archetype automatically
+generates the necessary descriptors.
+
+In addition to providing user interface through the Vaadin UI, portlets can
+integrate with the portal to switch between portlet modes and process special
+portal requests, such as actions and events.
+
+While providing generic support for all portals implementing the standard,
+Vaadin especially supports the Liferay portal and the needed portal-specific
+configuration in this chapter is given for Liferay. Vaadin also has a special
+Liferay IPC add-on to enable communication between portlets.
+
+
+