X-Git-Url: https://git.tokkee.org/?p=sysdb.git;a=blobdiff_plain;f=README;h=43f6f29aeab6e23bef9fb282f8d9e626a51abb16;hp=06c639f0dba11620f2220c4dd1261c4eed310a14;hb=HEAD;hpb=af09815c9b5e7c1dc194454c2f0378a6d8cc6c9a

diff --git a/README b/README
index 06c639f..43f6f29 100644
--- a/README
+++ b/README
@@ -16,13 +16,17 @@
   like a software system. Both, hosts and services, may reference a list of
   attributes which represent further information about the respective host or
   service object. For example, attributes may specify static information like
-  a host's architecture or the software version or reference performance data
-  like the current memory utilization or much more.
+  a host's architecture or the software version. A host may also reference a
+  list of metrics which are references to performance data stored about the
+  host. SysDB supports querying the respective time-series from a backend's
+  data store.
 
   SysDB is free and open source software, licensed under the 2-clause BSD
   license. See COPYING for details. Changes between all SysDB releases can be
   found in the file ReleaseNotes.
 
+  <https://sysdb.io/>
+
 Configure and install SysDB
 ---------------------------
 
@@ -47,7 +51,7 @@ Prerequisites
 
   To compile the SysDB package from source you need:
 
-  * A build environment: autotools, libtool, C compiler, ...
+  * A build environment: autotools, libtool, C and C++ compilers, ...
 
     <http://www.gnu.org/software/automake/>
     <http://www.gnu.org/software/autoconf/>
@@ -66,11 +70,10 @@ Prerequisites
 
     <http://pubs.opengroup.org/onlinepubs/9699919799/>
 
-  * asciidoc, xsltproc, xmlto:
+  * asciidoc, xmlto:
     The AsciiDoc text document format is used to write the manpages.
 
     <http://www.methods.co.nz/asciidoc/>
-    <http://xmlsoft.org/XSLT/>
     <https://fedorahosted.org/xmlto/>
 
   * libedit or libreadline:
@@ -84,15 +87,37 @@ Prerequisites
 
   * libdbi:
     The database independent abstraction layer is used for database access by
-    the puppet::store-configs plugin.
+    the backend::puppet::store-configs plugin.
 
     <http://libdbi.sourceforge.net/>
 
+  * libfacter:
+    The cfacter library for gathering facts about a system is used by the
+    backend::facter plugin to retrieve attributes about the local system.
+
+    <https://github.com/puppetlabs/cfacter>
+
+  * librrd:
+    The RRDtool library is used by the timeseries::rrdtool plugin to retrieve
+    time-series from RRD files.
+
+    <https://oss.oetiker.ch/rrdtool/>
+
+  * libssl:
+    The Secure Sockets Layer toolkit library is used to encrypt and
+    authenticate TCP connections.
+
+    <http://openssl.org/>
+
 Testing
 -------
 
   Unit and integration tests for SysDB are shipped along with the source code
-  in the ‘t’ subdirectory. Run ‘make test’ to run all available tests.
+  in the ‘t’ subdirectory. Run ‘make test’ to run all available tests or use
+  the following commands to run unit and integration tests separately:
+
+    make test TESTS='$(UNIT_TESTS)'
+    make test TESTS='$(INTEGRATION_TESTS)'
 
   Some tests require the ‘fopencookie’ function as provided by the GNU libc
   library. It used used to mock I/O related functions. In case this function
@@ -102,16 +127,34 @@ Testing
   tests will be disabled automatically.
 
   For the latest build status, see:
-  <https://travis-ci.org/tokkee/sysdb>
+  <https://travis-ci.org/sysdb/sysdb>
 
   Code coverage testing using Gcov may be enabled when using the
   ‘--enable-gcov’ configure option.
 
   For the latest coverage report, see:
-  <https://coveralls.io/r/tokkee/sysdb>
+  <https://coveralls.io/r/sysdb/sysdb>
+
+Documentation
+-------------
+
+  All documentation for SysDB is available as manual pages (in roff and HTML
+  formats) and shipped alongside the source code in the doc/ subdirectory.
+  Also, it is available online at <https://sysdb.io/documentation/>.
+
+Getting Help
+------------
+
+  Various channels for asynchronous and real-time communication with
+  developers and users are available. See <https://sysdb.io/contact/> for
+  details about the mailing list, IRC channel, and social media.
 
 Author
 ------
 
   Sebastian “tokkee” Harl <sh@tokkee.org>
 
+  See the file THANKS for credits and inspiration.
+
+  Want to contribute? Check out the website <https://sysdb.io> for details.
+