From 060cbae2cd6e0a64b76bf886f493ea4c16c10487 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Christian=20Th=C3=A4ter?= <ct@wolke.pipapo.org>
Date: Thu, 1 Nov 2018 01:17:10 +0100
Subject: [PATCH] DOC: Server and Mailinglists

---
 .../infra/Webserver/Mailinglists.txt          |  47 ++++++++
 doc/technical/infra/Webserver/Webserver.txt   | 112 ++++++++++++++++++
 2 files changed, 159 insertions(+)
 create mode 100644 doc/technical/infra/Webserver/Mailinglists.txt
 create mode 100644 doc/technical/infra/Webserver/Webserver.txt

diff --git a/doc/technical/infra/Webserver/Mailinglists.txt b/doc/technical/infra/Webserver/Mailinglists.txt
new file mode 100644
index 000000000..46ab0a561
--- /dev/null
+++ b/doc/technical/infra/Webserver/Mailinglists.txt
@@ -0,0 +1,47 @@
+Mailinglists
+============
+:Author: cehteh
+:Date: Nov 2018
+
+
+The Lumiera related Mailinglists.
+
+Main Webpage:: https://lists.lumiera.org/cgi-bin/mailman/listinfo
+
+Lumiera
+-------
+
+List address:: lumiera@lists.lumiera.org
+
+The main Lumiera Mailinglist. All Discussion, developers and users happens here.
+
+
+Lumiera-work
+------------
+
+List where automatic generated mails by the issue tracker and
+continious integration will go to.
+
+No users may post to this list (gets ignored/dropped).
+
+Lumiera-cc
+----------
+
+List address:: lumiera-cc@lists.lumiera.org
+
+Sometimes we have some emails we want to be archived and distributed
+among the developers. Like conference material/infos,
+invoices etc. These are CC:'ed to this ML. No discussion happens
+here. No public content here, but it's not hidden either.
+
+Server
+------
+
+List address:: server@lists.lumiera.org
+
+The Server we have is shared between multiple people. Administration
+discussion and issues which cover the Server as whole (and are not
+Lumiera specific) happen here. This mailinglist is a closed group of
+people and only people who are related to the server ins some way are
+subscribed.
+
diff --git a/doc/technical/infra/Webserver/Webserver.txt b/doc/technical/infra/Webserver/Webserver.txt
new file mode 100644
index 000000000..f110c1acc
--- /dev/null
+++ b/doc/technical/infra/Webserver/Webserver.txt
@@ -0,0 +1,112 @@
+Webserver Configuration
+=======================
+:Author: cehteh
+:Date: Nov 2018
+
+
+Here are some annotations which websites are available. Who is
+responsible for the administration and how to improve the websites.
+
+
+Websites
+--------
+
+https://lumiera.org https://www.lumiera.org
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The main Website.
+
+- Data is in '/var/www'. The Website is a git repository.
+- Configuration is at '/etc/apache2/sites-available/lumiera.conf'
+- cehteh cares for the administration.
+- To proprose some changes clone the git repository and send a
+  notfication/merge-request to the mailinglist.
+
+Some directories symlink to other directories (see below).
+
+
+https://staging.lumiera.org
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Testing repository for the Website. Web development is done and
+reviewed here before it gets pushed to the main Website.
+
+- Data is in '/var/www-staging'. The Website is a git repository.
+- Configuration is at '/etc/apache2/sites-available/staging.conf'
+- cehteh cares for the administration.
+- To proprose some changes clone the git repository and send a
+  notfication/merge-request to the mailinglist.
+
+
+https://git.lumiera.org
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The gitweb interface to all public git repositories hosted on the server.
+
+- Configuration is at '/etc/apache2/sites-available/gitweb.conf'
+- cehteh (and sometimes ichthyo) cares for the administration.
+
+
+
+https://issues.lumiera.org
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Trac issue tracker.
+
+- Configuration is at '/etc/apache2/sites-available/trac.conf'
+- ichthyo cares for the administration.
+
+
+https://static.lumiera.org
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Hosting big static files (media, videos, pictures)
+
+- Data is in '/var/local/www_static'. The Website is a git-annex repository.
+- Configuration is at '/etc/apache2/sites-available/static.conf'
+- cehteh cares for the administration.
+- we have a 'sample_archive' for some test-media/video files
+  there. People can contribute more media, ask on the mailinglist for
+  details.
+- Data will be placed there 'on-demand'. Don't forget to 'git annex add' the files.
+
+
+Directories
+-----------
+
+Some noteable directories.
+
+/git /var/local/git/
+~~~~~~~~~~~~~~~~~~~~
+Directories and symlinks to public git repositories served by the git
+daemon and gitweb.
+
+/var/local/tiddly/
+~~~~~~~~~~~~~~~~~~
+Git repository with the tiddlywiki used for some work notes during development.
+
+/var/local/www_debian/
+~~~~~~~~~~~~~~~~~~~~~~
+Debian package pool maintained by ichthyo.
+
+
+/var/local/doxy/
+~~~~~~~~~~~~~~~~
+API-Documentation generated by 'doxygen'.
+
+
+/var/local/gitmob/
+~~~~~~~~~~~~~~~~~~
+Public writable git repositories for receiving small and easy
+contributions.
+
+/var/local/rsyncd_incoming/
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Upload directory where people can rsync data.
+
+/var/local/www_documentation/
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Clone of the lumiera source repository to serve the documentation within.
+
+
+