Updated the README file with some more info according to our template

- also includes a little cleanup of "temporary" solution ~ already 7 years old and not in use anymore

README.md

@@ -1,5 +1,50 @@
-# YaST - The Installation Framework #
+YaST Installation Framework
+===========================
 
 [![Travis Build](https://travis-ci.org/yast/yast-installation.svg?branch=master)](https://travis-ci.org/yast/yast-installation)
 [![Jenkins Build](http://img.shields.io/jenkins/s/https/ci.opensuse.org/yast-installation-master.svg)](https://ci.opensuse.org/view/Yast/job/yast-installation-master/)
 
+
+Description
+============
+
+This repository contains an installation framework based on the shared
+functionality provided by [yast2](https://github.com/yast/yast-yast2/) project,
+especially on [these libraries]
+(https://github.com/yast/yast-yast2/tree/master/library/control/src/modules).
+
+The framework typically calls different *experts in the field*, such as Network,
+Storage or Users plug-ins to do the real job according to an installation
+workflow described in a particular control file for:
+
+- [openSUSE](https://github.com/yast/skelcd-control-openSUSE)
+- [SLES](https://github.com/yast/skelcd-control-SLES)
+- [SLED](https://github.com/yast/skelcd-control-SLED)
+
+More subject-specific pieces of information can be found in the [doc](doc)
+directory.
+
+Development
+===========
+
+This module is developed as part of YaST. See the
+[development documentation](http://yastgithubio.readthedocs.org/en/latest/development/).
+
+
+Getting the Sources
+===================
+
+To get the source code, clone the GitHub repository:
+
+    $ git clone https://github.com/yast/yast-installation.git
+
+If you want to contribute into the project you can
+[fork](https://help.github.com/articles/fork-a-repo/) the repository and clone your fork.
+
+
+Contact
+=======
+
+If you have any question, feel free to ask at the [development mailing
+list](http://lists.opensuse.org/yast-devel/) or at the
+[#yast](https://webchat.freenode.net/?channels=%23yast) IRC channel on freenode.