Tool Use: Who Works Who?
I don't want to use Word, Pages, Open Office or any WP. These are vestiges of the command and control origins of computing with the emphasis firmly on uniformity of work flow. The are two parts to a WP-ing document 1) Content 2) Form. These are intermingled to such an extent that it is almost impossible to escape the structure imposed by the WP. This is handy for enforcing memo standards across cubicle America, but lousy for collaborating on academic work.
Example Problem: At yesterday's meeting we discussed various sections of the library report (which has now grown to 5 authors spread over two rural counties) such as; Who should be responsible for which particular sections (and the sundry housekeeping tasks). Of course, this inevitably brings up the more onerous question: Who is responsible for keeping the single document up to date and disseminating the changes as they are incorporated?
What happens: Dissemination is done irregularly at odd intervals and usually under deadline duress, thus leaving the collaborators in the dark for long stretches. I think this is as much the fault of the WP as any person. There is simply no easy way to institute distributed versioning or to make changes visible to everyone all the time. Only the lead author knows exactly where the document is at any given point - thus turning the lead into a de facto corporate-style micro manager.
A few starting points towards a solution: 1) I do not want to mix typesetting and type. 2) I do want to share text via email or a version control system. 3) ASCII is still the universal format being flexible, lightweight, and easily adaptable, so whatever tool we use must deal primarily in ASCII. 4) I want to move documents from informal beginnings towards more (or less)formal endings.
A document which would allow TODOs and/or Agenda items to be interactively embedded directly into the document would be an added bonus. In addition the ability to tag sections of the document with tags we define would also be a great help.
(Re)Opening the Black Box:
I will borrow an idea from Jefferson and stake out my task as looking to the middle landscape of digital tools. Tools which are neither overly constraining nor so flexible that the learning curve is too time consuming to ascend. There exists no gentle way to drop the WP. It requires getting your hands dirty and actively re-working some tools. This means lifting the hood and playing with minor amounts of code and configuration settings. Is this hard? Yes, but the minor amount of pain caused by configuration and coding is nothing when compared to the daily indignities heaped upon me by WORD.
I have, with help from some programming friends, arrived at a more flexible setup that allows me to divorce myself completely of the WP game (except for something to open the annoying .doc and .docx files). The set up consists of three tools which play nicely with each other, and whatever else I may CHOOSE to use, plus allow me share as much or as little as I wish.
Org-Mode
I have settled on org-mode as my new all purpose writing tool. Org-mode is an Emacs major mode, so it has the advantages of having full access to the power (while abstracting out most of the complexity) of Emacs. Org-Mode is a handy outliner, note taker, and drafting tool (creates tables, etc...) .It exports to html, LaTex, and so forth. It Integrates with R - for the Quantitators and/or data hipsters amongst us- and most of all org-mode provides a gentle ramp for starting documents informally and incrementally adding layers of formality as the document moves towards completion or abandonment.
http://orgmode.org/ http://orgmode.org/worg/ http://orgmode.org/GoogleTech.html Git
Distributed Version control. Designed by Linus Torvalds for Linux kernel development. Kernel development is essentially a large writing project involving a few hundred authors spread out worldwide.
Just a few of the pressing questions that Git can elegantly answer:
1) See changes over time - Where are we going? Where have we been?
2) Who has made changes? Why? Should I cut off contributor X?
3) How can I roll back the changes I don't like?
4) Can we branch this and spawn a new paper?
http://git-scm.com/ http://www.eecs.harvard.edu/~cduan/technical/git/ Dropbox
Dropbox installs as a local folder and, unlike most web based file sharing solutions, holds local copies of documents. When combined with GIT this makes an ideal distributed version control system for files under 2gb.
http://www.getdropbox.com/ ** Getting Git to work with Dropbox
http://www.cimgf.com/2008/06/03/version-control-makes-you-a-better-programmer/