dev + troubleshooting guide

2 files changed, 48 insertions, 0 deletions

diff --git a/doc/DEVELOPMENT.md b/doc/DEVELOPMENT.md
new file mode 100644
index 0000000..e773c2c
--- /dev/null
+++ b/doc/DEVELOPMENT.md
@@ -0,0 +1,9 @@
+You want to improve Stikked? Always welcome! Send us your pull request and you will be honoured in AUTHORS.md.
+
+Some guidelines:
+
+* For PHP only files (not views/themes), please run the PHP Beautifier (http://pear.php.net/package/PHP_Beautifier) with the following parameters:
+```bash
+php_beautifier --indent_tabs -l "IndentStyles(style=bsd) ArrayNested() NewLines(before=function:T_CLASS:if,after=T_COMMENT) ListClassFunction()"
+```
+* Other people may modify your contribution. Don't take that personal; we all want to improve Stikked. Your input is always welcome!
diff --git a/doc/TROUBLESHOOTING_GUIDE.md b/doc/TROUBLESHOOTING_GUIDE.md
new file mode 100644
index 0000000..3b0809b
--- /dev/null
+++ b/doc/TROUBLESHOOTING_GUIDE.md
@@ -0,0 +1,39 @@
+Stikked troubleshooting guide
+-----------------------------
+
+### Apache
+
+#### 404 Not Found after creating a Paste
+
+Rewrite rules must be enabled in httpd.conf.
+
+### Nginx
+
+#### 502 Bad Gateway
+
+PHP FastCGI must be running. Here's my /etc/init.d/php-fgci config:
+
+```bash
+#!/bin/bash
+
+FASTCGI_USER=www-data
+FASTCGI_GROUP=www-data
+ADDRESS=127.0.0.1
+PORT=9000
+PIDFILE=/var/run/php-fastcgi.pid
+CHILDREN=6
+PHP5=/usr/bin/php5-cgi
+
+/usr/bin/spawn-fcgi -a $ADDRESS -p $PORT -P $PIDFILE -C $CHILDREN -u $FASTCGI_USER -g $FASTCGI_GROUP -f $PHP5
+```
+
+You can adapt that to your system.
+
+### Lighttpd
+
+### Cherokee
+
+Still have a problem?
+---------------------
+
+Report an issue at GitHub, and we will add your problem to this guide.