From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?windows-1252?Q?=D3scar_Fuentes?= Subject: Re: Org-mode as a bug tracker. Date: Sun, 19 Jul 2009 23:12:58 +0200 Message-ID: <87bpng74x1.fsf@telefonica.net> References: <87ocrj728a.fsf@telefonica.net> <87fxcv6zvc.fsf@telefonica.net> <87zlb28e0k.fsf@bzg.ath.cx> Mime-Version: 1.0 Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 8bit Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MSdhF-0001Jm-V2 for emacs-orgmode@gnu.org; Sun, 19 Jul 2009 17:13:25 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MSdhA-0001HB-8w for emacs-orgmode@gnu.org; Sun, 19 Jul 2009 17:13:24 -0400 Received: from [199.232.76.173] (port=55198 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MSdhA-0001H8-3y for emacs-orgmode@gnu.org; Sun, 19 Jul 2009 17:13:20 -0400 Received: from main.gmane.org ([80.91.229.2]:44994 helo=ciao.gmane.org) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MSdh9-0005Zs-G7 for emacs-orgmode@gnu.org; Sun, 19 Jul 2009 17:13:19 -0400 Received: from list by ciao.gmane.org with local (Exim 4.43) id 1MSdgz-0006ls-Vf for emacs-orgmode@gnu.org; Sun, 19 Jul 2009 21:13:10 +0000 Received: from 184.red-83-53-125.dynamicip.rima-tde.net ([83.53.125.184]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 19 Jul 2009 21:13:09 +0000 Received: from ofv by 184.red-83-53-125.dynamicip.rima-tde.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 19 Jul 2009 21:13:09 +0000 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Bastien writes: >>> Any reasons why this is not a good idea? >> >> Just remembered that time ago, when the bug tracker for Emacs was >> discussed, Bastien proposed to use org-mode for it. > > Actually I'm glad you bring this up again, as I want to work on this > proposal again. > > There are actually two ideas: > > (1) use org-mode instead of outline-mode in Emacs internal files > etc/TODO and admin/FOR-RELEASE. This is pretty straightforward > and not a big change. As a minimal change, it improves the way we > can navigate through these files, but it opens new possibilities > about adding milestones, tagging tasks, keep track of the email > which originated the task, assign them to someone, etc. Using org-mode instead of outline-mode is a no-brainer. The only incovenient is org's complexity. A basic but effective use of org is straightforward but its extensive documentation may seem daunting for the occasional user. Maybe a paragraph or two at the beginning of the file explaining what's required for adding entries and doing simple queries would help those developers who don't know nor plan to use org for other uses. > (2) use org-mode as a collective bug tracker. > > Let me dwell a bit on the second idea. > > A good bug tracker for Emacs would let both users and developers easily > access (read/write) to a constantly updated bugs database. > > One way to do this with Org files is the "Worg" way: share Org files > over git (or bzr) and let's people contribute to it. However, this is > not a good solution for *users*. Even for developers it's not usable: > people will have to pull the last version of the bug database to check > that they are not working on the same things... too bad. > > Another solution would be to take the Worg road only for publishing the > Org bug database, and take another road for writing stuff into it. I > think a clever system combining HTML input and mail interactions could > do it: > > - A HTML form would let users fill a bug report that would be add to > the Org bug database; > > - M-x report-emacs-bug would be sent to a machine able to extract an > Org subtree from the email and add it to the Org bug database; > > - When a developer is taking any action on a bug (revising, closing, > etc) he emails the updated version of the task to the system and the > system takes care of replace the old entry by the new one. > > - Whenever X changes an entry assigned to Y, Y receives an email > asking for permission about this changes. If yes, then the change > is applied to the bug database, if no it isn't. > > This is the basic workflow. Of course, permissions and other issues > could be refined but I think such a system is feasible. IMAO this setup is more complex and fragile than a conventional bug tracker. The idea may seem appealing at first for a group of veteran emacs users (those who insist on managing the bug database via e-mail because they refuse to use a web browser, for instance) but I'm far from convinced about its effectiveness. >> I argued against because the Emacs bug database would soon fill >> dozens of megabytes and this volume does not fit the philosophy of a >> text-based database. > > I don't think the size of the database would really be an issue for the > system above - but maybe I'm wrong on this. I'm afraid you are. Lots of emacs bug reports comprises hundreds of lines of stack dumps, plus e-mail discussions with lots of quoted text, etc. Org is great for notes, but is it practical for containing tens of thousands of bug reports, some of them made of thousands of lines? And you don't control what's on a bug report, they usually contain all sorts of text constructs and random characters. How well it would deal with bug reports about org's itself, containing excerpts from other org files? Wouldn't this confuse org? >> Another nuisance is attached files. This requires an ad-hoc mechanism >> and I'm not sure I want them stored along with the source files. > > I guess 20MB is because there are many files attached - as Matt > mentioned you can attach files *outside* the bug database so this > isn't really an issue. Nope, the 20MB is the bugs' text alone. But attached files belong to the tickets and supposedly provide key information, so you can wipe them away to a place where they are not distributed along with the bug database. I think org as a bug tracker may work very well for individual developers or for small groups, but not for open big projects such as emacs. -- Óscar