From 7b2ea4fd1a371f7d92f113387a00932516e10675 Mon Sep 17 00:00:00 2001 From: Alexander Pickering Date: Sun, 29 Oct 2017 16:22:55 -0400 Subject: Added readme --- README.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..82366d1 --- /dev/null +++ b/README.md @@ -0,0 +1,30 @@ +# Simple Open Bug and Error Reporter + +SOBER is a smimple web-based bug reporter. It is written in ANSI C and should work on any posix-compliant platform & web server with cgi support. + +You can find a demo instance at [cogarr.net/demos/sober](https://cogarr.net/demos/sober) + +## Installation + +To install, +1. clone this repo +2. edit config.h +3. edit the first 3 lines of build.bat or build.sh +4. run the build.bat or build.sh script. +5. point your web server to the cgi-bin directory. +SOBER should set up it's files as needed. + +## Usage +People that need to use the bug tracker should have access (ex over ssh) to the deploy/bugs directory. Each bug has a id# as a filename. You can search for bugs by using grep. Ex: +`grep "0:" *` will find all open bugs + +To give feedback to the users of the site, change the 5th line in the bug report. It has the format : +statis can be: + +* 0 : unassigned, text MUST NOT exist +* 1 : assigned, text will be displayed +* 2 : closed, text MUST NOT exist + +## Misc +If your filesystem supports it, "lock" the file while it is being edited by a developer, so that data submitted by users is not overwritten. + -- cgit v1.2.3-70-g09d2