Created Sphinx framework with sphinx-quickstart and added .txt extensiosns

1 files changed, 46 insertions, 0 deletions

diff --git a/doc/distributed_bugtracking.txt b/doc/distributed_bugtracking.txt
new file mode 100644
index 0000000..1164c14
--- /dev/null
+++ b/doc/distributed_bugtracking.txt
@@ -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.