docs: improve README

README.md

@@ -1 +0,0 @@
-docs/index.md

README.md

@@ -0,0 +1,59 @@
+# <img src="https://pwr-solaar.github.io/Solaar/assets/solaar.svg" width="60px"/> Solaar
+
+Solaar is a Linux manager for many Logitech keyboards, mice, and other devices
+that connect wirelessly to a Unifying, Bolt, Lightspeed or Nano receiver
+as well as many Logitech devices that connect via a USB cable or Bluetooth.
+
+
+<a href="https://pwr-solaar.github.io/Solaar/index">More Information</a> -
+<a href="https://pwr-solaar.github.io/Solaar/usage">Usage</a> -
+<a href="https://pwr-solaar.github.io/Solaar/capabilities">Capabilities</a> -
+<a href="https://pwr-solaar.github.io/Solaarrules">Rules</a> -
+<a href="https://pwr-solaar.github.io/Solaar/installation">Manual Installation</a>
+
+
+[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2+-blue.svg)](../COPYING)
+
+<img src="https://pwr-solaar.github.io/Solaar/Solaar-main-window-multiple.png" width="45%"/>
+&#160;
+<img src="https://pwr-solaar.github.io/Solaar/Solaar-main-window-receiver.png" width="45%"/>
+
+<img src="https://pwr-solaar.github.io/Solaar/Solaar-main-window-back-divert.png" width="45%"/>
+&#160;
+<img src="https://pwr-solaar.github.io/Solaar/Solaar-rule-editor.png" width="45%"/>
+
+Solaar supports:
+- pairing/unpairing of devices with receivers
+- configuring device settings
+- custom button configuration
+- running rules in response to special messages from devices
+
+For more information see
+    <a href="https://pwr-solaar.github.io/Solaar/index">the main Solaar documentation page.</a> -
+
+
+## Installation Packages
+
+Up-to-date prebuilt packages are available for some Linux distros
+(e.g., Fedora) in their standard repositories.
+If a recent version of Solaar is not
+available from the standard repositories for your distribution, you can try
+one of these packages:
+
+- Arch solaar package in the [extra repository][arch]
+- Ubuntu/Kubuntu package in [Solaar stable ppa][ppa2]
+- NixOS Flake package in [Svenum/Solaar-Flake][nix flake]
+
+Solaar is available from some other repositories
+but may be several versions behind the current version:
+
+- for Ubuntu/Kubuntu 16.04+: the solaar package from [universe repository][universe repository]
+- a [Gentoo package][gentoo], courtesy of Carlos Silva and Tim Harder
+- a [Mageia package][mageia], courtesy of David Geiger
+
+[ppa2]: https://launchpad.net/~solaar-unifying/+archive/ubuntu/stable
+[arch]: https://www.archlinux.org/packages/extra/any/solaar/
+[gentoo]: https://packages.gentoo.org/packages/app-misc/solaar
+[mageia]: http://mageia.madb.org/package/show/release/cauldron/application/0/name/solaar
+[universe repository]: http://packages.ubuntu.com/search?keywords=solaar&searchon=names&suite=all&section=all
+[nix flake]: https://github.com/Svenum/Solaar-Flake

docs/index.md

@@ -106,12 +106,11 @@ available from the standard repositories for your distribution, you can try
 one of these packages.
 
 - Arch solaar package in the [extra repository][arch]
-- Ubuntu/Kubuntu stable packages: use the [Solaar stable ppa][ppa2], courtesy of [gogo][ppa4]
-- Ubuntu/Kubuntu git build packages: use the [Solaar git ppa][ppa1], courtesy of [gogo][ppa4]
-- NixOS Flake: see [Svenum/Solaar-Flake][nix flake]
+- Ubuntu/Kubuntu package in [Solaar stable ppa][ppa2]
+- NixOS Flake package in [Svenum/Solaar-Flake][nix flake]
 
 Solaar is available from some other repositories
-but they are several versions behind the current version.
+but they may be several versions behind the current version.
 
 - for Ubuntu/Kubuntu 16.04+: the solaar package from [universe repository][universe repository]
 - a [Gentoo package][gentoo], courtesy of Carlos Silva and Tim Harder
@@ -121,8 +120,6 @@ Solaar uses a standard system tray implementation; solaar-gnome3 is no longer re
 
 [ppa4]: https://launchpad.net/~trebelnik-stefina
 [ppa2]: https://launchpad.net/~solaar-unifying/+archive/ubuntu/stable
-[ppa1]: https://launchpad.net/~solaar-unifying/+archive/ubuntu/ppa
-[ppa]: http://launchpad.net/~daniel.pavel/+archive/solaar
 [arch]: https://www.archlinux.org/packages/extra/any/solaar/
 [gentoo]: https://packages.gentoo.org/packages/app-misc/solaar
 [mageia]: http://mageia.madb.org/package/show/release/cauldron/application/0/name/solaar