[gnome-panel] doc: update introduction chapter of reference manual

[Sebastian Geiger <segeiger src gnome org>]

commit 6e05b0727ff4dd4235546c36d20a347f5a233aaf
Author: Sebastian Geiger <sbastig gmx net>
Date:   Fri Sep 11 23:14:00 2015 +0200

    doc: update introduction chapter of reference manual

 doc/reference/panel-applet/panel-applet-docs.sgml |   18 +++++++++++++-----
 1 files changed, 13 insertions(+), 5 deletions(-)
---
diff --git a/doc/reference/panel-applet/panel-applet-docs.sgml 
b/doc/reference/panel-applet/panel-applet-docs.sgml
index 97adbe9..c82d6bd 100644
--- a/doc/reference/panel-applet/panel-applet-docs.sgml
+++ b/doc/reference/panel-applet/panel-applet-docs.sgml
@@ -39,13 +39,21 @@
     <title>Introduction</title>
 
     <para>
-     While applets are rather simple to write, they are not the most easy form of interaction to users for 
two reasons: it is not intuitive how to add or remove applets for many users, and the restriction in size of 
applets can limit their interface. Therefore, before writing an applet, think hard whether this is the form 
of interaction that is best for the feature you want to provide.
+     While applets are rather simple to write, they are not the most easy form of interaction to users for 
two reasons:
+     <itemizedlist>
+        <listitem>
+            It is not intuitive how to add or remove applets for many users, so users may not know about 
your applet,
+            or may not know how to add it to the GNOME Panel.
+        </listitem>
+         <listitem>
+            The restriction in size of applets can limit their interface, so you should only use applets for 
simple
+            tasks such as displaying information, or for controlling other applications and programs.
+         </listitem>
+     </itemizedlist>
+     Therefore, before writing an applet, think hard whether this is the form of interaction that
+     is best for the feature you want to provide.
     </para>
 
-    <note><simpara>
-     Keep in mind that starting with GNOME 3, the panel and applets are only available in the fallback mode. 
An applet will therefore not be usable in the default GNOME that users may use.
-    </simpara></note>
-
    </chapter>
 
    <chapter id="getting-started.concepts">