From 99d6de546c74f0eed230ea8253dda6b85109d2e7 Mon Sep 17 00:00:00 2001
From: Markus Koivisto <markus@vaadin.com>
Date: Fri, 22 Jan 2016 14:55:18 +0200
Subject: Add documentation to master branch

Change-Id: I2504bb10f1ae73ec0cbc08b7ba5a88925caa1674
---
 documentation/portal/portal-overview.asciidoc | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 documentation/portal/portal-overview.asciidoc

(limited to 'documentation/portal/portal-overview.asciidoc')

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.
+
+
+
-- 
cgit v1.2.3

