diff --git a/README b/README
index 4d03b2c..4e9e6c9 100644
--- a/README
+++ b/README
@@ -1,2 +1,27 @@
 
   Codeine - a very simple xine-based media player.
+
+
+Codeine is a media player with a simple, uncluttered interface.
+It can play play DVDs, VCDs, all video formats supported by the Xine
+library.
+
+
+Features:
+=========
+
+* Bundled with a simple web-page KPart
+* Starts quickly
+
+
+
+CONTRIBUTING
+==============
+
+If you wish to contribute to codeine, you might do so:
+
+- TDE Gitea Workspace (TGW) collaboration tool.
+  https://mirror.git.trinitydesktop.org/gitea
+
+- TDE Weblate Translation Workspace (TWTW) collaboration tool.
+  https://mirror.git.trinitydesktop.org/weblate