[gnome-devel-docs/dx-hackfest] platform-overview: Fill in the Polkit page

[Federico Mena Quintero <federico src gnome org>]

commit 46bfdaa5b906786e38140af816a5d9d4e94dfc8a
Author: Federico Mena Quintero <federico gnome org>
Date:   Fri Feb 1 17:18:21 2013 +0100

    platform-overview: Fill in the Polkit page
    
    Signed-off-by: Federico Mena Quintero <federico gnome org>

 platform-overview/C/index.page     |    2 +-
 platform-overview/C/policykit.page |   11 ----------
 platform-overview/C/polkit.page    |   38 ++++++++++++++++++++++++++++++++++++
 3 files changed, 39 insertions(+), 12 deletions(-)
---
diff --git a/platform-overview/C/index.page b/platform-overview/C/index.page
index a402df5..b17b914 100644
--- a/platform-overview/C/index.page
+++ b/platform-overview/C/index.page
@@ -64,7 +64,7 @@ on each part of the platform.</p>
   <title>Multimedia</title>
 </links>
 
-<links type="topic" style="toronto" groups="d-bus policykit">
+<links type="topic" style="toronto" groups="d-bus polkit">
   <title>Inter-process communication</title>
 </links>
 
diff --git a/platform-overview/C/polkit.page b/platform-overview/C/polkit.page
new file mode 100644
index 0000000..02df0fc
--- /dev/null
+++ b/platform-overview/C/polkit.page
@@ -0,0 +1,38 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="policykit">
+<info>
+  <link type="guide" xref="index" group="policykit"/>
+  <desc>Access control for system-level services provided through D-Bus</desc>
+</info>
+
+<title>Polkit</title>
+
+  <p>
+    Polkit, or Policy Kit, hanels the policies that let unprivileged processes
+    talk to privileged ones via <link xref="d-bus">D-Bus</link> APIs.  For
+    example, not all programs should be allowed to request that the machine be
+    disconnected from the network via the <link
+      xref="NetworkManager">NetworkManager</link> service.
+  </p>
+
+  <p>
+    Polkit lets the system administrator define different policies for
+    different services.  For example, only a user with physical access to the
+    console may mount/unmount drives and volumes; users that are not at the
+    console will need to type an administrator password.  On a machine for home
+    users, most policies will be rather liberal, as the users can be trusted to
+    take care of the machine.  On corporate settings, policies may be more
+    restricted.
+  </p>
+
+  <p>
+    GNOME uses PolicyKit whenever applications need to request privileged
+    operations.
+  </p>
+
+  <list style="compact">
+    <item><p><link href="http://www.freedesktop.org/wiki/Software/polkit";>Polkit home page</link></p></item>
+  </list>
+
+</page>
\ No newline at end of file