[WIP] New repository structure

README.md

@@ -1,10 +1,23 @@
 gitlab-recipes
 ==============
 
-GitLab recipes for setup on different platforms, update etc...
+GitLab recipes for setup on different platforms, update etc.
 
-### Every file should have section with maintainer name & gitlab version:
+## Guidelines on community contributions
 
-    # GITLAB
-    # Maintainer: @randx
-    # App Version: 5.0
+Here you will find installation guides or automation scripts provided by the community, 
+for systems other than the officially supported (Debian/Ubuntu).
+
+Bare in mind that this repository is co-maintained by volunteers/contributors like you.
+
+### Accepting Pull Requests
+
+In each parent directory (install, init, web-server, etc.) you will find some conventions
+you need to follow in order for your Pull Request to be accepted.
+
+Please stick as close as possible to the guidelines. That way we ensure quality guides
+and easy to merge requests.
+
+Your Pull Request will be reviewed by one of our volunteers and you will be
+asked to reformat it if needed. We don't bite and we will try to be as flexible
+as possible, so don't get intimidated by the extent of the quidelines :)

install/README.md

@@ -0,0 +1,44 @@
+## Naming guidelines
+
+- consists? >= 2 files:
+
+archlinux-gitlab
+
+## General information
+
+If you have an installation guide to provide, fill in the template and place it on top
+of your guide or include it in your installation script (commented), again on top.
+
+### Template
+
+```
+Distribution      : 
+GitLab version    : 
+Web Server        : 
+Init system       : 
+Contributor       : 
+Additional Notes  : 
+```
+
+### Explanation
+
+| Label            | Explanation |
+| ---------------- | ------------------------- |
+| Distribution     | The official name and version of the platform/distribution, case sensitive.  |
+| GitLab version   | GitLab version on which the guide/script was tested.    |
+| Web Server       | The web server used to serve GitLab. May be two-fold, eg. apache with mod_passenger.  |
+| Init system      | (Optional but recommended) The init system used by the platform if any. Examples: **sysvinit**, **systemd**, **upstart**, **openrc**, etc |
+| Contributor      | Your github username (recommended in order to track you and give credits) or your real name or both. Example of the latter: **thedude (Jeffrey Lebowski)** |
+| Additional Notes | Anything else you want to add. Any deviations form the official guide can be reported here. Eg. using different user than `git`, storing in different locations, etc.|
+
+
+### Example
+
+```
+Distribution      : Fedora 19
+GitLab version    : 5.4
+Web Server        : apache with mod_passenger 
+Init system       : systemd
+Contributor       : thedude
+Additional Notes  : the script installs `postgres` instead of `mysql` and user is `gitlab` instead of `git`
+```

install/archlinux/README.md

@@ -0,0 +1,14 @@
+Welcome to the Archlinux GitLab recipes. Here you will find installation scripts,
+guides, how-tos and some useful links that will help you install GitLab on Archlinux.
+
+
+## Useful links
+
+* [GitLab Wiki][]
+* [GitLab PKGBUILD][]
+* [gitlab-shell PKGBUILD][]
+
+
+[GitLab Wiki]: https://wiki.archlinux.org/index.php/Gitlab
+[GitLab PKGBUILD]: https://github.com/mtorromeo/archlinux-packages/tree/master/gitlab
+[gitlab-shell PKGBUILD]: https://github.com/mtorromeo/archlinux-packages/tree/master/gitlab-shell

install/gentoo/README.md

@@ -0,0 +1,5 @@
+## Links
+
+* http://wiki.gentoo.org/wiki/GitLab
+* https://gist.github.com/int128/2360407
+* https://github.com/cvut/gentoo-overlay/tree/master/www-apps/gitlabhq 

web-server/nginx/README.md

@@ -0,0 +1,10 @@
+# CentOS related Nginx notes
+
+* If nginx is installed through the package manager, adjust sites in conf.d instead of sites-enabled.
+
+* Replace the default `nginx` user with `gitlab` in group `root`.
+
+  In `/etc/nginx/nginx.conf`:
+
+      #user              nginx;
+      user              gitlab root;