[owncloud/el6] revise the main README

[Adam Williamson]

commit d45e5169998919b5f5d7033e377412495cdf4745
Author: Adam Williamson <awilliam at redhat.com>
Date:   Wed Oct 29 16:27:32 2014 -0700

    revise the main README

 owncloud-README.fedora |   55 ++++++++++++++++++++++++++++-------------------
 1 files changed, 33 insertions(+), 22 deletions(-)
---
diff --git a/owncloud-README.fedora b/owncloud-README.fedora
index 9a3d6ec..1baef21 100644
--- a/owncloud-README.fedora
+++ b/owncloud-README.fedora
@@ -4,7 +4,7 @@ ownCloud packaging notes
 Start
 ------
 After installation you should be able to access the login/configuration page
-on following url:
+at the following URL:
 
 http://localhost/owncloud/ or http://localhost/
 
@@ -12,46 +12,57 @@ If not, make sure your webserver is running properly.
 
 Webserver
 ---------
-Currently ownCloud in Fedora supports following webserver: httpd and nginx.
-You must install at least on webserver subpackage (owncloud-<webserver>). These
-packages include additional configuration files for the webservers. Note that
-these files are just samples. For production setup you should adjust them to
-your needs. Also remote access is disabled by default.
+Currently ownCloud in EL 6 supports httpd (Apache) and nginx. You must install
+at least one webserver subpackage (owncloud-<webserver>). These packages
+include additional configuration files for the webservers. Note that these
+files are just samples. For production setup you should adjust (or, better,
+override) them to your needs. Remote access is disabled by default.
 
 Database
 --------
-You can choose between 3 databases: MySQL, Postgresql and SQLite.
-For each of them exists a corresponding owncloud subpackage (owncloud-<database>).
-You are required to install at least one of them.
+You can choose between three databases: MySQL, PostgreSQL and SQLite.
+For each of them there is an ownCloud subpackage (owncloud-<database>).
+You are required to install at least one of them. The packages only ensure
+the necessary requirements to communicate with a database server of that type
+are installed, they do not require the database server package itself, as
+you may wish to use a remote database server. If you wish to use a local one,
+you must ensure it is installed and configured.
 
 For larger installs you should use MySQL or PostgreSQL.
 
-If you choose MySQL or PostgreSQL, keep in mind that you must create a database and user
-for owncloud manually, before you can finish the setup process.
-
-For specific instructions, please refer to the documentation in the database subpackages.
+If you choose MySQL or PostgreSQL, keep in mind that you must create a database
+and user for owncloud manually, before you can finish the setup process. The
+README.postgresql and README.mysql files provide more details and help with
+this.
 
 Configuration
 -------------
-You can find the main configuration file at '/etc/owncloud/config.php'
-A default configuration file with a lot of comments is included in the documentation.
+You can find the main configuration file at '/etc/owncloud/config.php'. Until
+you first access the server it will be just a small stub containing settings
+that differ in this package from the upstream defaults. After you first access
+ownCloud, the initial setup process will populate it with some more settings.
+Other settings that can be provided in this file are documented at:
+http://doc.owncloud.org/server/6.0/admin_manual/config/default_parameters.html
 
 User Data
 ---------
-The default data directory is '/var/lib/owncloud/data'. Every file that is uploaded
-by your users to ownCloud gets saved into this folder. Consider doing a backup of this
-directory, together with the database and the main configuration.
+The default data directory is '/var/lib/owncloud/data'. Every file that is
+uploaded by your users to ownCloud gets saved into this folder. Consider doing
+a backup of this directory, together with the database and the main
+configuration. Note that if you change this location, you must set appropriate
+ownership and SELinux context attributes.
 
 Logging
 -------
-Specified by the main configuration, ownCloud sends messages to the system
+As specified by the configuration file, ownCloud sends messages to the system
 logger ('syslog'). You can also change the loglevel or switch to the built-in
 log mechanism of ownCloud.
 
 App Store
 ---------
-If you install additional third party apps using the built-in app store, you can find them
-in the directory '/var/lib/owncloud/apps'. This functionality is enabled by default.
+If you install additional third party apps using the built-in app store, you
+can find them in the directory '/var/lib/owncloud/apps'. This functionality is
+enabled by default.
 
 
-For further informations see also: http://owncloud.org/
+For further information see http://owncloud.org/ and http://doc.owncloud.org/