From f3ebfa50b83bd6dccfb6ef07d7c34c4cd0257371 Mon Sep 17 00:00:00 2001
From: "N. Geisler" <ngeisler@fachschaft.informatik.tu-darmstadt.de>
Date: Wed, 9 Oct 2019 22:14:42 +0200
Subject: [PATCH] insert README

add short project description
add requirements
add setup instructions
---
 README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b7e9f22
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+# AK Planning
+
+## Description
+
+AKPlanning is a tool used for modeling, submitting, scheduling and display AKs (German: Arbeitskreise), meaning workshops, talks or similar slot-based events.
+
+It was built for KIF (German: Konferenz der deutschsprachigen Informatikfachschaften), refer to [the wiki](wiki.kif.rocks) for more Information.
+
+
+## Setup
+
+This repository contains a Django project with several apps.
+
+
+### Requirements
+
+AKPlanning has two types of requirements: System requirements are dependent on operating system and need to be installed manually beforehand. Python requirements will be installed inside a virtual environment (strongly recommended) during setup.
+
+
+#### System Requirements
+
+* Python 3.7
+* Virtualenv
+
+
+#### Python Requirements
+
+Python requirements are listed in ``requirements.txt``. They can be installed with pip using ``-r requirements.txt``.
+
+
+### Development Setup
+
+* create a new directory that should contain the files in future, e.g. ``mkdir AKPlanning``
+* change into that directory ``cd AKPlanning``
+* clone this repository ``git clone URL .``
+
+1. setup a virtual environment using the proper python version ``virtualenv env -p python3.7``
+1. activate virtualenv ``source env/bin/activate``
+1. install python requirements ``pip install -r requirements.txt``
+1. setup necessary database tables etc. ``python manage.py migrate``
+1. create a priviledged user, credentials are entered interactively on CLI ``python manage.py createsuperuser``
+1. deactivate virtualenv ``deactivate``
+
+To start the application for development use ``python manage.py runserver 0:8000`` from the root directory.
+*Do not use this for deployment!*
+
+In your browser, access ``http://127.0.0.1:8000/wannaDB/`` and continue from there.
-- 
GitLab