docs: make it pretty

[thirdparty/systemd.git] / docs / index.md

diff --git a/docs/index.md b/docs/index.md
index ffb30b9634c0f227741059df8f4dd23b1dd690d9..0368417184916083f8f1cb212694b5e9192746ca 100644 (file)
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,11 +1,26 @@
 ---
-title: systemd Documentation
+layout: default
 ---
 
-# systemd Documentation
+systemd is a suite of basic building blocks for a Linux system. It provides a system and service manager that runs as PID 1 and starts the rest of the system.
+  
+systemd provides aggressive parallelization capabilities, uses socket and D-Bus activation for starting services, offers on-demand starting of daemons, keeps track of processes using Linux control groups, maintains mount and automount points, and implements an elaborate transactional dependency-based service control logic. systemd supports SysV and LSB init scripts and works as a replacement for sysvinit. 
 
-{% for p in site.pages %}
-  {% if p.url != page.url and p.title %}
-* [{{ p.title }}]({{ p.url | relative_url }})
+Other parts include a logging daemon, utilities to control basic system configuration like the hostname, date, locale, maintain a list of logged-in users and running containers and virtual machines, system accounts, runtime directories and settings, and daemons to manage simple network configuration, network time synchronization, log forwarding, and name resolution.
+
+See the introductory blog story and three status updates for a longer introduction. Also see the [Wikipedia article](https://en.wikipedia.org/wiki/systemd).
+
+---
+
+{% assign by_category = site.pages | group_by:"category" %}
+{% assign extra_pages = site.data.extra_pages | group_by:"category" %}
+{% assign merged = by_category | concat: extra_pages | sort:"name" %}
+
+{% for pair in merged %}
+  {% if pair.name != "" %}
+## {{ pair.name }}
+{% assign sorted = pair.items | sort:"title" %}{% for page in sorted %}
+* [{{ page.title }}]({{ page.url | relative_url }}){% endfor %}
   {% endif %}
 {% endfor %}
+