aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorW. Trevor King <wking@drexel.edu>2010-01-03 11:06:48 -0500
committerW. Trevor King <wking@drexel.edu>2010-01-03 11:06:48 -0500
commitf08a1e8e195b37bef4bc78e5f66ae730c9ee061e (patch)
tree53b06279962d9bd28319ff72be4066726a69d1b3 /doc
parentdba76dc22663f3614d1c6a14fa1a79aee77034c7 (diff)
downloadbugseverywhere-f08a1e8e195b37bef4bc78e5f66ae730c9ee061e.tar.gz
Added doc/distributed_bugtracking with some simple use-case notes
Diffstat (limited to 'doc')
-rw-r--r--doc/distributed_bugtracking46
1 files changed, 46 insertions, 0 deletions
diff --git a/doc/distributed_bugtracking b/doc/distributed_bugtracking
new file mode 100644
index 0000000..1164c14
--- /dev/null
+++ b/doc/distributed_bugtracking
@@ -0,0 +1,46 @@
+Usage Cases
+===========
+
+Case 1: Tracking the status of bugs in remote repo branches
+-----------------------------------------------------------
+
+See discussion in
+ #bea86499-824e-4e77-b085-2d581fa9ccab/12c986be-d19a-4b8b-b1b5-68248ff4d331#
+Here, it doesn't matter whether the remote repository is a branch of
+the local repository, or a completely separate project
+(e.g. upstream, ...). So long as the remote project provides access
+via some REPO format, you can use
+ be --repo REPO ...
+to run your query, or
+ be diff REPO
+to see the changes between the local and remote repositories.
+
+
+Case 2: Importing bugs from other repositories
+----------------------------------------------
+
+Case 2.1: If the remote repository is a branch of the local repository
+ VCS merge REPO
+Case 2.2: If the remote repository is not a branch of the local repository
+ Hypothetical command:
+ be import REPO ID
+
+
+Notes
+=====
+
+Providing public repositories
+-----------------------------
+
+e.g. for non-dev users. These are just branches that expose a public
+interface (HTML, email, ...). Merge and query like any other
+development branch.
+
+
+Managing permissions
+--------------------
+
+Many bugtrackers implement some sort of permissions system, and they
+are certainly required for a central system with diverse user roles.
+However DVCSs also support the 'pull my changes' workflow, where
+permissions are irrelevant.