[gnome-devel-docs/wip/kill-integration-guide] WIP move integration guide topics into platform overview

[David King <davidk src gnome org>]

commit dff2ed7c503d5e175d48be0bfdd33c5f27d30a46
Author: David King <amigadave amigadave com>
Date:   Mon Jan 27 18:59:12 2014 +0000

    WIP move integration guide topics into platform overview

 platform-overview/C/dev-launching-desktop.page |   73 ++++++++++++++++++++++++
 platform-overview/C/dev-launching-icons.page   |   33 +++++++++++
 platform-overview/C/dev-launching.page         |   35 +++++++++++
 platform-overview/C/index.page                 |    2 +-
 4 files changed, 142 insertions(+), 1 deletions(-)
---
diff --git a/platform-overview/C/dev-launching-desktop.page b/platform-overview/C/dev-launching-desktop.page
new file mode 100644
index 0000000..fd43db1
--- /dev/null
+++ b/platform-overview/C/dev-launching-desktop.page
@@ -0,0 +1,73 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="task"
+      id="dev-launching-desktop">
+
+  <info>
+    <link type="next" xref="dev-launching-icons"/>
+    <revision version="0.1" date="2014-01-27" status="draft"/>
+
+    <credit type="author">
+      <name>David King</name>
+      <email its:translate="no">davidk gnome org</email>
+      <years>2014</years>
+    </credit>
+
+    <include href="cc-by-sa-3-0.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+  </info>
+
+  <title>Install a desktop file</title>
+
+  <links type="series" style="floatend">
+    <title>Launch your application</title>
+  </links>
+
+  <p>Write and install a desktop file so that users can discover and launch
+  your application.</p>
+  
+  <p>GNOME uses the freedesktop.org Desktop Entry and Desktop Menu
+  specifications to describe application launchers. Installing a desktop file
+  is the standard way to register your application with GNOME and other
+  desktops.</p>
+  
+  <p>A desktop file lists your application binary, name and type, and can also
+  list an icon, description and several other pieces of information about
+  launching an application.</p>
+
+  <p>For a hypothetical application <app>My Application</app>, a desktop file
+  would look as follows:</p>
+  <example>
+    <listing>
+      <title><file>myapplication.desktop</file></title>
+<code>[Desktop Entry]
+Name=My Application
+Exec=myapplication
+Type=Application
+Icon=myapplication
+Comment=Do the thing that the application does
+Categories=GTK;GNOME;Utility;</code>
+    </listing>
+  </example>
+
+  <p>The <code>[Desktop Entry]</code> line indicates that this is a desktop
+  file. It is followed by keys, which describe the application launcher. The
+  <code>Name</code> key is the human-readable name of the application, to be
+  shown in the UI. The application binary is listed in the <code>Exec</code>
+  key, either the complete path or a binary that is looked up in the
+  <code>PATH</code>. The last required key is the <code>Type</code>, which for
+  applications is always <code>Application</code>. Alternative types are listed
+  in the desktop entry specification.</p>
+
+  <p>Other fields in the desktop file are optional, but recommended.
+  Applications should install an icon, and list the name of the icon (excluding
+  the extension) in the <code>Icon</code> key. The <code>Comment</code> is a
+  brief description of the application. To help users when browsing
+  applications, the <code>Categories</code> key should be populated with a
+  list of categories, separated by a semicolon, from the Desktop Menu
+  Specification.</p>
+
+  <p>There are several other keys that can be added to desktop files, which are
+  listed and described in the Desktop Entry Specification.</p>
+ 
+</page>
diff --git a/platform-overview/C/dev-launching-icons.page b/platform-overview/C/dev-launching-icons.page
new file mode 100644
index 0000000..49a1b46
--- /dev/null
+++ b/platform-overview/C/dev-launching-icons.page
@@ -0,0 +1,33 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="task"
+      id="dev-launching-mime">
+
+  <info>
+    <link type="next" xref="dev-launching-icons"/>
+    <revision version="0.1" date="2014-01-27" status="draft"/>
+
+    <credit type="author">
+      <name>David King</name>
+      <email its:translate="no">davidk gnome org</email>
+      <years>2014</years>
+    </credit>
+
+    <include href="cc-by-sa-3-0.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+  </info>
+
+  <title>Install an icon</title>
+
+  <links type="series" style="floatend">
+    <title>Launch your application</title>
+  </links>
+
+  <p>Install an icon to identify your application.</p>
+  
+  <p>GNOME uses the freedesktop.org Desktop Entry and Desktop Menu
+  specifications to describe application launchers. Installing a desktop file
+  is the standard way to register your application with GNOME and other
+  desktops.</p>
+ 
+</page>
diff --git a/platform-overview/C/dev-launching.page b/platform-overview/C/dev-launching.page
new file mode 100644
index 0000000..440cc6c
--- /dev/null
+++ b/platform-overview/C/dev-launching.page
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="task"
+      id="dev-launching">
+
+  <info>
+    <link type="guide" xref="index" group="launching"/>
+    <link type="next" xref="dev-launching-desktop"/>
+    <link type="seealso" xref="dev-translate"/>
+
+    <revision version="0.1" date="2014-01-27" status="draft"/>
+
+    <credit type="author copyright">
+      <name>David King</name>
+      <email its:translate="no">davidk gnome org</email>
+      <years>2014</years>
+    </credit>
+
+    <include href="cc-by-sa-3-0.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Showing a launcher and starting your application.</desc>
+
+  </info>
+
+  <title>Application launching</title>
+
+  <links type="series" style="floatend">
+    <title>Launch your application</title>
+  </links>
+
+  <p>An icon in the launcher is the standard way to launch your application.
+  Use the freedesktop.org Desktop Entry Specification standard to create a
+  desktop file, giving your application name, icon and a brief description.</p>
+
+</page>
diff --git a/platform-overview/C/index.page b/platform-overview/C/index.page
index 37b3854..193ebba 100644
--- a/platform-overview/C/index.page
+++ b/platform-overview/C/index.page
@@ -62,7 +62,7 @@
     <links type="topic" style="2column" groups="#first ui"/>
   </section>-->
 
-  <links type="topic" style="grid center" groups="help translate">
+  <links type="topic" style="grid center" groups="launching help translate">
     <title style="heading">Integration guides</title>
   </links>