6200 comments
2357 subscribers
Follow me on Twitter (@sachac)
Subscribe! Feed reader E-mail

Remembering what should go in the book

Writing a book about an open source editor and its extensions is
difficult. I want to describe many of the things people can do in
order to customize and make the most of Emacs, but I don’t want to
just rewrite the manual. I find myself summarizing a few bits and
expounding on others.

The key thing I want to add to this is excitement. I want people to be
able to *see* what these changes result in and how those changes will
improve their productivity or make them happier. ;) (Tall order for a
text editor!) I want this book to be less about a laundry list of
things people can do and more about looking over geeks’ shoulders and
being inspired to hack and learn more. That’s the kind of book I want
to write: a book that makes people go, “You can do that with Emacs?!”
I want to write a book that convinces people to spend some time
exploring the limits of their software (even vi!), because hidden
features can totally rock. I also want to write a book that shows how
all these little things combined can be absolutely cool, the way my
Planner+BBDB+Gnus+everything-else combination works out really well
for me. The whole is more than the sum of its parts.

I sometimes find it hard to hang on to that thought when I’m reading
the user’s manual and trying to make sure I’m covering the essentials.
I find myself writing from the point of view of the software instead
of from the point of view of the user. What I need to do is to focus
on the user’s story, on the problem or idea or opportunity. *Then* I
can write about solutions for that. I think I need to change the
outline I’m working with—it’s too software-centric.

It doesn’t have to be a perfect book, but I want it to be exciting and
alive. =)

Random Emacs symbol: tramp-uudecode – Variable: Shell function to implement `uudecode’ to standard output.

Short URL: http://sachachua.com/blog/p/4389

On This Day...

  • 2011: Tweaking my Windows 7 setup more: Emacs on all virtual desktops! — I’ve been using VirtuaWin to set up four virtual desktops on my computer. This makes it easy to group applications: [...]
  • 2010: Cleaning up HTML from Microsoft Word — I often see HTML pasted in from Microsoft Word. It has a lot of non-standard and irrelevant code in it, [...]
  • 2009: Find your attention wandering during teleconferences? — Find your attention wandering during teleconferences? The temptation to check your mail or surf the Web is hard to resist [...]
  • 2008: It’s a little bit scary — I feel a bit nervous. There’s a lot of shifting around, and lots of things I wonder about, too. I’m [...]
  • 2005: Who needs a gym when there’s laundry to be done? — Whew. Bushed. I’ve taken all my cold-weather clothes out of vacuum-packed bags and hung them up neatly. I washed all my [...]
  • 2005: Hey! I’m in the ACM Digital Library! — ACM Digital Library entry for Taming the TODO Okay, I’ve officially screwed up in terms of names now… All of my research [...]
  • 2005: Bookmarking beyond the browser — Bookmarking web pages is a breeze with tag-based bookmarking services like del.icio.us, which reduced the need for up-front organization and [...]
  • 2005: More thoughts about Google — My computing dream: universal bookmarking My dream for computing is universal bookmarking. I want to be able to bookmark and link to [...]
  • 2004: Typhoon — A typhoon is supposed to hit our area tomorrow, so I’ve taken the precautions of removing my clothes from the balcony. [...]
  • 2004: Halloween coming up — Looks like people are gearing up for Halloween. I’m looking forward to seeing the costumes. Fortunately, the 31st is a Sunday. [...]
  • 2004: LAZYBONES — The lambanog-soaked farmer snored, lulled to sleep by the carabao’s steady rhythm as it navigated the muddy trail home. The coarse, [...]
  • 2004: On obfuscating e-mail messages — Responded to a thread on PLUG with http://lists.q-linux.com/pipermail/plug/2004-October/037001.html: > Unfortunately, there is evidence that spambots have gained in > 'intelligence' (if one [...]
  • 2004: More uncharacteristically business-y thoughts — The inner marketing geek resurfaced in an e-mail to Sean. By the way, I’m not recommending being insincere. I’m just recommending looking [...]
  • 2003: 10 things about life Hong Kong taught me in 24 hours, from Kathy — According to Kathy, my sister: 10 things about life Hong Kong taught me in 24 hours. 1. It pays to be a [...]
  • 2003: Gender confusion again — From someone whom I shall keep anonymous (pfft!): From: "***** *. *****" Subject: RE: Linux Expo To: "'Sacha Chua'" sacha, are you [...]
  • 2003: planner-move-task-to-plan-page — Cross-reference: PlannerMode#6