Merge branch 'tari01-pr/add-documentation'

Attributes GH PR #12: https://github.com/AyatanaIndicators/ayatana-indicator-application/pull/12

3 files changed, 101 insertions, 2 deletions

diff --git a/INSTALL.md b/INSTALL.md
new file mode 100644
index 0000000..f993e9c
--- /dev/null
+++ b/INSTALL.md
@@ -0,0 +1,51 @@
+# Build and installation instructions
+
+## Compile-time build dependencies
+
+ - cmake (>= 3.13)
+ - cmake-extras
+ - glib-2.0 (>= 2.58)
+ - ayatana-indicator3-0.4 (>= 0.6.2)
+ - gtk+-3.0 (>= 3.24)
+ - ayatana-appindicator3-0.1 (>= 0.5.5)
+ - dbus-glib-1 (>=0.110)
+ - dbusmenu-gtk3-0.4
+ - systemd
+ - intltool
+ - gtest (>= 1.6.0)
+ - gmock
+ - gcovr (>= 2.4)
+ - lcov (>= 1.9)
+
+## For end-users and packagers
+
+```
+cd ayatana-indicator-application-X.Y.Z
+mkdir build
+cd build
+cmake ..
+make
+sudo make install
+```
+## For testers - unit tests only
+
+```
+cd ayatana-indicator-application-X.Y.Z
+mkdir build
+cd build
+cmake .. -DENABLE_TESTS=ON
+make
+make test
+```
+## For testers - both unit tests and code coverage
+
+```
+cd ayatana-indicator-application-X.Y.Z
+mkdir build
+cd build
+cmake .. -DENABLE_COVERAGE=ON
+make
+make test
+make coverage-html
+```
+**The install prefix defaults to `/usr`, change it with `-DCMAKE_INSTALL_PREFIX=/some/path`**
diff --git a/README b/README
deleted file mode 100644
index e2fd122..0000000
--- a/README
+++ /dev/null
@@ -1,2 +0,0 @@
-A readme is the very beginning, a very nice place to start.  When you read
-you begin with A-B-C when you code you begin with RE-AD-ME!
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e5d278c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,50 @@
+# ayatana-indicator-application -  Ayatana Indicator Application Service  [![Build Status](https://travis-ci.com/AyatanaIndicators/ayatana-indicator-application.svg)](https://travis-ci.com/AyatanaIndicators/ayatana-indicator-application)
+
+## About Ayatana Indicators
+
+The Ayatana Indicators project is the continuation of Application
+Indicators and System Indicators, two technologies developed by Canonical
+Ltd. for the Unity7 desktop.
+
+Application Indicators are a GTK implementation of the StatusNotifierItem
+Specification (SNI) that was originally submitted to freedesktop.org by
+KDE.
+
+System Indicators are an extensions to the Application Indicators idea.
+System Indicators allow for far more widgets to be displayed in the
+indicator's menu.
+
+The Ayatana Indicators project is the new upstream for application
+indicators, system indicators and associated projects with a focus on
+making Ayatana Indicators a desktop agnostic technology.
+
+On GNU/Linux, Ayatana Indicators are currently available for desktop
+envinronments like MATE (used by default in [Ubuntu
+MATE](https://ubuntu-mate.com)), XFCE (used by default in
+[Xubuntu](https://bluesabre.org/2021/02/25/xubuntu-21-04-progress-update/),
+LXDE, and the Budgie Desktop.
+
+The Lomiri Operating Environment (UI of the Ubuntu Touch OS, formerly
+known as Unity8) uses Ayatana Indicators for rendering its notification
+area and the [UBports](https://ubports.com) project is a core contributor
+to the Ayatana Indicators project.
+
+For further info, please visit:
+https://ayatana-indicators.org
+
+## About this Software Component
+
+The -application Ayatana System Indicator is an application menu indicator
+for Unity7, MATE and Lomiri (optionally for others, e.g. XFCE, LXDE). The
+indicator takes menus from applications and places them into the panel.
+
+Its behavior and features are listed at
+https://wiki.ayatana-indicators.org/AyatanaIndicatorApplication
+
+## License and Copyright
+
+See COPYING and AUTHORS file in this project.
+
+## Building and Testing
+
+For instructions on building and running built-in tests, see the INSTALL.md file.