From 73097df356637372f5a18cadb9ac37d597aa2d24 Mon Sep 17 00:00:00 2001 From: Aaron Bentley Date: Sat, 3 Dec 2005 18:35:35 -0500 Subject: Updated docs --- README | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 0000000..9867264 --- /dev/null +++ b/README @@ -0,0 +1,35 @@ +Bugs Everywhere +=============== +This is Bugs Everywhere, a bugtracker built on distributed revision control. +It works with Bazaar-NG and Arch at the moment, but is easily extensible. It +can also function with no RCS at all. + +The idea is to package the bug information with the source code, so that +bugs can be marked 'fixed' in the branches that fix them. So, instead of +numbers, bugs have ids. + +Getting started +=============== +To get started, you must set the bugtracker root. Typically, you will want to +set the bug root to your project root, so that Bugs Everywhere works in any +part of your project tree. +$ be set-root $PROJECT_ROOT + +To create bugs, use "be new $DESCRIPTION". To comment on bugs, you can can use +"be comment $BUG_ID". To close a bug, use "be close $BUG_ID". For more +commands, see "be help" + +Using BeWeb, the web UI +======================= +BeWeb uses the Turbogears framework: http://www.turbogears.org/ +Please ensure you have Turbogears 0.8a4 or a compatible release installed. +Because it uses BE data, the web UI does not require a database. + +To use BeWeb, first create a configuration file, telling it which projects +to track, and what to call them. An example configuration file +(beweb/beweb/config.py.example) is provided. + +Next, cd to beweb, and run ./beweb-start.py + +BeWeb allows you to create, view and edit bugs, but it is in an early stage of +development, so some features are missing. -- cgit