[libsecret/wip/nielsdg/update-readme] Update README

[Niels De Graef <nielsdg src gnome org>]

commit 7f71290c8e1916b262412f84264f94da4ecbcf83
Author: Niels De Graef <nielsdegraef gmail com>
Date:   Tue May 21 21:54:53 2019 +0200

    Update README
    
    Use markdown formatting (which displays more nicely in GitLab now that
    we migrated) and give a bit of context to users.

 README    |  2 --
 README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 48 insertions(+), 2 deletions(-)
---
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fb44051
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+libsecret
+=========
+
+A [GObject]-based library for accessing the Secret Service API of the
+[freedesktop.org project], a cross-desktop effort to access passwords, tokens
+and other types of secrets. libsecret provides a convenient wrapper for these
+methods so consumers do not have to call the low-level DBus methods.
+
+The actual Secret Service API spec can be found at
+https://specifications.freedesktop.org/secret-service/.
+
+Building
+--------
+
+To build and install libsecret, you can use the following commands:
+
+```
+$ meson _build
+$ ninja -C _build
+$ ninja -C _build install
+```
+
+Contributing
+-------------
+
+You can browse the code, issues and more at libsecret's [GitLab repository].
+
+If you find a bug in libsecret, please file an issue on the [issue tracker].
+Please try to add reproducible steps and the relevant version of libsecret.
+
+If you want to contribute functionality or bug fixes, please open a Merge
+Request (MR). For more info on how to do this, see GitLab's [help pages on
+MR's].
+
+If libsecret is not translated in your language or you believe that the
+current translation has errors, you can join one of the various translation
+teams in GNOME. Translators do not commit directly to Git, but are advised to
+use our separate translation infrastructure instead. More info can be found at
+the [translation project wiki page].
+
+
+
+[GObject]: https://developer.gnome.org/gobject/stable/
+[freedesktop.org project]: https://www.freedesktop.org/
+[GitLab repository]: https://gitlab.gnome.org/GNOME/libsecret
+[help pages on MR's]: https://docs.gitlab.com/ee/gitlab-basics/add-merge-request.html
+[issue tracker]: https://gitlab.gnome.org/GNOME/libsecret/issues
+[translation project wiki page]: https://wiki.gnome.org/TranslationProject/