Document Geek

Author: Jeff Anderson

All through High School, I struggled in English class. I never broke a C in any English class I ever took. When I got to college, I managed a B in my Freshman English class. I find myself looking up those pesky grammar rules, and even submitting tickets and patches to emerging open source projects which were written by people like me-- lots of spelling errors and some ugly grammar mistakes.

I've contributed to Django's documentation. I submitted a patch to fix "noone" ("no one" is correct.) in a couple places on the open source MMORPG called "The Mana World."

I've become almost a professional note taker, and I get irked when I have a teacher who uses all caps in an outline, or consistently spells something wrong that a spell checker is sure to have complained about.

I was driven nuts when I opened a handout in plain html. The formatting was terrible. The document referenced lots of scripture references. I converted the whole thing to ReStructured text, fixed my teachers spelling errors (I just used the spell checker in vim), and linkified the scripture references. I generated a PDF and after 20 minutes spent on the stupid document, I finally read my assignment.

Have I gotten so concerned about my own bad grammar and spelling that I've become gasp an English person? I really doubt it, but I'm turning into a document structure geek. I basically have my own style guide I follow.

I spent 20 minutes fixing a document I was supposed to read, and it only took me ten minutes to read it. All my modifications are likely to be all for nothing. I guess I could e-mail back the rest source, generated html, and generated PDF, but my teacher wouldn't know what to do with the ReST source, and would probably bother me to port his changes to the html file back into the PDF.

I'm not so sure that all that time spent was worth it in the end. Maybe I should just send the generated html back and call it good. He probably put the thing together in frontpage, or had a TA do it. Maybe I'll just send my revisions to the TA and not worry about actually getting it pushed out and in use.

Posted: Oct 19, 2008 | Tags: Documents OCD School

Comments are closed.