Creative Commons

I discovered the other day that Yahoo! has launched a Creative Commons Search. Nifty stuff! I am pleased to note that the goer.org HTML 4.01 Tutorial is currently the #2 result for the search “html tutorial”. This despite the fact that the tutorial isn’t finished, and was mostly written before I understood the difference between “tags” and “elements”. Hmmmm. I think the tutorial could use some spiffing up…

In other Creative Commons-related news: via Tim Bray I discovered a curious statement from Bob Wyman, who claims that the Creative Commons “non-commercial” license does not actually do anything to prevent commercial use. Wyman’s reasoning is:

Given the notes on the Creative Commons site, and a closer reading of the Creative Commons licenses themselves, it seems like what is being said by the CC “NonCommercial” license is not that commercial use is denied, but rather that non-commercial use is permitted. The focus is on what is permitted, not what is denied.

First, as far as I can tell, the text of the NonCommercial License explicitly states that commercial usage is prohibited: “Noncommercial. You may not use this work for commercial purposes.” Legal jargon is tricky, and designed to trip up non-lawyers and rubes such as ourselves. That said, I am not sure how a “closer reading” would come to some other conclusion.

Second, let’s imagine we live in a universe where the NonCommercial license didn’t say “you may not use this work for commercial purposes.” Let’s say it said, “You may use this work for non-commercial purposes” instead. I don’t see how this would make any difference. By default, you cannot take my copyrighted material without my permission and use it for either A) non-commercial or B) commercial purposes (modulo fair use and parody considerations). If I then subsequently grant you permission to use some of my copyrighted material for A), that doesn’t mean you are suddenly granted permission to use it for B) also. Unless B) is a subset of A). Which it isn’t, at least if I understand the English prefix, “non-“.

Or am I missing something? I am not a lawyer. Then again, as far as I can tell, neither is Bob. Creative Commons licenses might have other structural problems, but I don’t see how this particular issue is one of them.

The Technical Writer Song

To the tune of “Paperback Writer“:

Dear Senior Engineer, will you review my doc?
It took me months to write, fought through the writer’s block.
Based on a spec by an insane architect
And I need a job, so I want to be a technical writer,
Paperback writer.

It’s the dirty story of a dirty API
Undocumented methods piled high
Just makes you want to pull your hair or bail
It’s a steady job but I want to be a technical writer,
Technical writer.

Technical writer (writer, writer)

It’s a thousand pages, give or take a few,
I’ll be sending it out for a Peer Review.
I can make it longer if you like the style,
I can change it ’round and I want to be a technical writer,
Technical writer.

If you really like it we’ll ship it right away
Forget the editing, we’ll get it out today.
But you must return it, in print or PDF,
I just need a break and I want to be a technical writer,
Technical writer.

Technical writer (writer, writer)

Technical writer – Technical writer
Technical writer – Technical writer

Ehhh, maybe I should keep my day job.

1. It turns out that someone wrote an even better version several years ago, but hey, I didn’t know about it when I wrote this.

2. More tech writer verse by yours truly.

Would You Buy a Used Computer From This Man?

So I’ve purchased a 256 MB SODIMM from a very nice fellow on the Ars Technica Agora Classifieds forum. The extra stick of RAM is really for my kid sister’s iBook, when she gets back for Thanksgiving. Friends don’t let friends run OS X on 256 MB of RAM, folks, and that goes double for big brothers and little sisters.

I’ve also managed to sell my Powerbook to the mother of an old friend of mine, in order to subsidize the purchase of of a brand-new iBook. It was sort of a reckless purchase, but I figured that while I had a desktop, I didn’t really need the SuperDrive, DVI-out, and other Powerbook features, while I did care about the faster CPU, 802.11g card, and better battery life of the new iBook. I suppose I could have scrounged up more cash if I had sold the Powerbook on eBay or Craigslist[1] but it was nice to not have to worry about shipping, and even nicer to know that I was actually going to get a real check from a real, non-deadbeat person. I should note that when I brought over the ‘book so that my prospective buyer could “kick the tires”, she brought out tomato soup and toast and fruit salad for lunch. When was that last time that happened to you on eBay? I’m guessing, never.

Anyway, I think I have figured out my Computing Nirvana. Right now, I have a main desktop and a laptop. Ideally, I would have one machine. Here’s what I’m thinking. By this summer, Tiger should be out, and the Powerbook line should be refreshed at least once. (The Powerbooks are overdue — they’re looking really bad compared to the iBooks right now.) So sometime this summer, I sell the iBook and the G4 desktop and get the bestest 12″ Powerbook I can afford, with Bluetooth, wireless keyboard and mouse, and external firewire drive for backup. Then I can use the Powerbook in closed-lid mode most of the time — but when I want to go work outside, I can unplug the display, pop in the battery, and go. Best of both worlds, I think. And no more syncing between machines. I am done with that.

I’m also looking forward to playing with the new VoiceOver spoken interface. Macintoshes have had nifty voice features for a long time now,[2], but supposedly Tiger’s version is going to be, to use the technical term, way cooler. And that’s a good thing. ‘Cause life needs to be a little more like Star Trek.

1. Particularly Craigslist. I think Apple makes some fine machines, but what are those people thinking?

2. $ say -v Zarvox 'Greetings, meatbag!'

Envy Is So Unbecoming…

A few months ago, an friend of mine from HMC forwarded us all a link to a Channel 9 discussion about Microsoft’s Avalon project, hosted by fellow ’97 alum Joe Beda. The general reaction of the recipients was, “Holy crap, Joe’s gone bald!” I didn’t care about the hair; my reaction was, “Holy crap, Joe’s one of the lead developers on Avalon!”

Fast forward a few months, and it turns out Joe has left his high-profile job at Microsoft, to take another job at Google. I don’t know how high-profile this new Google job is, but apparently it’s important enough to be reported in nationally-syndicated media outlets.

Well, Joe says it’s not all that newsworthy… but come on, can’t you just smell the false humility? I’m all about rooting for my fellow alumni,[1] but this is starting to get ridiculous. To Joe I say, pbbbbhhllt! At least I still have all my hair.

1. I’m trying to think of other HMC grads who are moderately famous in the software world. Bookmarklet guru Jesse Ruderman springs to mind, but these days he’s mainly famous for his interest in porn. The only other one I can think of is Wes Cherry, that dude who invented Windows Solitaire for free when he was an intern. Well, that’s something, at least.

Supercharge Your Outlook Performance!

My new desktop at work has finally arrived. Out with the old Dell, in with the new. The new machine has twice the memory and about four times the processor speed of the old machine. Presumably it plays Quake really well.[1] However, its most salient benefits are:

  • It reboots really, really fast.
  • It’s actually pretty quiet. Outstanding.

So after several days of blood, sweat, and more than a few tears, all my applications are loaded and working properly… with the curious exception of ClearCase, which still refuses to read the main Engineering Documents VOB. Fortunately, it’s not like my job depends on reading engineering specs.

Actually, the application that gave me the most trouble was Outlook. Displaying a message was taking over three seconds, as compared to, oh, 30 milliseconds on my old, “obsolete” machine. We soon determined that A) it was a client-side problem, and B) uninstalling and reinstalling Outlook and Office didn’t help.

Fortunately, before the IT guys got a chance to take stronger measures, I found the solution. Poking around in the settings, I discovered that the checkbox next to “Enable Instant Messaging in Outlook” was checked. That setting looked weird to me, so I unchecked it and restarted Outlook. Lo and behold, Outlook was fast again! I checked the box, restarted, and yes, Outlook was slow again. Unchecked, fast again. I {heart} reproducible errors. So, to sum up: if you want Outlook to run fast, uncheck that Instant Messaging box. I suppose having three orders of magnitude more RAM than the computers on the Space Shuttle probably wouldn’t hurt either.

So while my apps are working okay now, I am still struggling to restore my environment to a usable state. Outlook is particularly obnoxious, as its preferences are scattered throughout at least several screens. It took me about five months to tweak it into shape the last time around. I should note that the IT guys did mention that I could migrate all my preferences and documents in one step. However, they claimed this would involve generating a gigantic multi-gigabyte file, and any registry cruft in my old profile would get loaded right along with all the useful stuff. The clean install sounded a lot better after that.

All I’m saying is, it would be really nice if Outlook could export its preferences to a file.[2] Although hey, you know what would be even better? What if we had a system where all well-behaved applications stored their preferences in easily-readable text files? Heck, maybe they could even store all their preferences under a common directory. Just imagine, you could copy the old directory to the new machine, swap it in, and presto! — all your applications would just work. That would be some sweet-ass technology. Boy howdy.

1. Although its Quake performance might be hampered a bit by the fact that it uses onboard graphics and sound.

2. Maybe it can, but darned if I could find the option.

But I’m Not Sure About Frannie

Bad news: Adobe has killed FrameMaker for MacOS. I can assure you that the MacOS FrameMaker user community is outraged. Well… okay, I can only really assure you that half the MacOS FrameMaker user community is outraged. The other half consists of Francine Kopecki, a 53-year-old contract technical writer in Lansing, Michigan. Not exactly sure what Frannie thinks, but at least I’m plenty annoyed.

Of course, the writing was on the wall, so there’s no point in being too upset. Some people speculate that if Adobe had gotten around to porting FrameMaker to OS X, it might have done a little better in the marketplace. I can certainly say that I would have snapped up an OS X version, but again, I can’t speak for Frannie. Besides, FrameMaker would have just looked weird in OS X. Can you imagine taking that horrible CDE-inspired interface and spraying on a light coat of Aqua? Perhaps it’s best that Adobe never unleashed that monstrosity on the unsuspecting public.

The only upside from all this has been amusing flood of Recommendations For FrameMaker Replacements From People Who Have Never In Their Lives Actually Used FrameMaker. InDesign? OpenOffice? Stop, you’re killing me!

Well, at least we can all take comfort in the fact that Adobe’s development efforts for FrameMaker are abysmally slow. It will probably be years before they manage to crank out FrameMaker 8.0, and the serious backwards-compatibility issues start in earnest. Huzzah for lack of competition! Still, unlike Adobe, I can’t rest on my laurels. Even though the day of FrameMaker 8.0 is probably far off, it’s important to start spewing a thick cloud of FUD at work now, well before my company decides to upgrade. “Did you hear? Adobe’s using a new kind of shrinkwrap that’s highly teratogenic.” My luck, they’ll just make me open the box.

Horse of a Different Colour

Intrepid J2EE nerd Charles Miller is annoyed with Apple’s USA-centrism, at least when it comes to spelling.[1] For the record, I’ve worked for three USA companies that had writers in the UK… and I have to say that I have always taken great pleasure in pointing out to my colleagues across the pond that in this company we’re standardized on U.S. English, and by the way, that’s “standardized“, not “standardised”…

Well, of course I’m kidding. I’m actually very nice when I’m editing.

No, I’m not.

On a related matter, I’ve always wondered about the Anglo-centrism of computer languages. Consider the case of a non-English-speaking developer who’s starting to learn Java. The reserved words (“if”, “else”, “for”, “this”, …) are in English, which almost certainly results in annoying overhead. To make matters worse for our developer, all of the standard packages (and most 3rd-party packages) are in English too. If you speak English, you can often guess what a Java method call does — for example, HashMap.clear() probably, err, clears a hashmap. But if your sole language was French or Korean, you wouldn’t know what “clear” or “hashmap” were unless you had run across those words before (perhaps earlier in your career). In any case, your learning curve for Java or any other high-level language[2] would be steeper than than a native English speaker’s. And it would be even worse if you didn’t know the character set. Imagine as an English speaker, having to learn to code using Arabic or Japanese Kanji. What a pain that would be.

Of course, there’s no reason that you couldn’t have a development environment that allows you to code in your native language, and then automagically transforms the source into the associated English source code. That should be pretty straightforward for the basic language keywords and any standard libraries, anyway. I wonder if such a feature exists? Hmmm.

1. Having recently reinstalled my PowerBook’s operating system, I can also state for the record that Apple clearly favors Swedes over Norwegians. The Swedish localization files install before the Norwegian files, in blatant disregard for alphabetical order.

2. Except for UNIX shell scripting, which is gibberish in any language.

This Conversation Never Happened

‘Tis the day before Thanksgiving, and I expect the office will be deserted. One thing I know for sure is that all my fellow tech writers have decided to take a vacation day. My boss’s parting words were, “Hold down the fort.” She left off the “comma, kid” at the end, thank goodness.

Of course holding down the fort won’t be too difficult; even a lone tech writer can be awfully intimidating. Case in point: a few weeks ago, I ran into one of our senior engineers in the hallway. “Hey, did you send me a review copy of your new guide?” he asked.

“Oops,” I said. “You were supposed to be on the list, but I completely forgot. Sorry about that. I’ll email you a copy.”

His face fell. “No no,” he said, backing away slowly, “No need for that…” And with that, he turned and fled. “This conversation never happened!”

But They’re Doing It In Shelbyville!

Huh. Well, that was… something. Is it too late to come up with a Return of the King stylesheet?[1]

A few months ago, I decided to experiment with opening up comments. The experiment has turned out to be a lot of fun, a great success… and yet it has also brought its share of headaches, in the form of comment spam. Fortunately I don’t get a lot of comment spam, but it sure is annoying to clean up these little nastygrams.

It just so happens that earlier this week, on the very day I was grumbling and going through my ritual cleansing-of-the-comments, GMSV pointed to a somewhat relevant Business Week article by e-marketeer Christopher Kenton. The article argues that California’s new opt-in antispam law will hurt small businesses. Unfortunately, Mr. Kenton had difficulty switching his writing style from “marketing whitepaper” to “editorial article”. But it’s hard to blame him for this — there are some unfortunates who simply don’t have an off switch for that kind of blather, and so it falls on the rest of us to be patient and understanding. We can only hope that for the sake of his family, he at least leaves it at the office.

Anyway, if you slog though Kenton’s dismal prose, his editorial boils down to two points:

  1. The California anti-spam law will crush entrepreneurs, because it causes small startups to lose a powerful and inexpensive marketing tool.

  2. The California anti-spam law can’t be enforced anyway, because the spammers will just move out of the state.

The first argument is rather charming, in a musty sort of way. It reminds me of Late Medieval and Early Renaissance scholars, pondering the ruins of the Ancient World. “The Ancients were Giants among Men!” goes this line of thinking. “How can we hope to match their achievements? They built the Pyramids! They wrote the Illiad! They somehow managed to sell their products and services without resorting to unsolicited email!” How were such ingenious feats possible? I suppose Mr. Kenton is free to argue that the small businesses of 2003 are demonstrably more stupid and feeble than the small businesses of 1993. I guess I just have considerably more faith in the American entrepreneur than he does.

The second argument brings to mind another analogy. Imagine a large freshwater lake that is ringed by a number of small towns, each of which is dumping its wastewater into the lake. The water is becoming undrinkable, and something has to be done. Let’s say that the citizens of Springfield pass a law banning the dumping of untreated water into the lake. Now imagine you’re at a council meeting at one of the other towns, debating the merits of the brand-new Springfield law. A man stands up and says, “Why the heck should we ban the dumping of wastewater? Even if we do, they’ll still be doing it in Shelbyville!”

And so the argument goes. If you make a strict law banning unsolicited email in California, the spammers will just move out and spam us from somewhere else, like Nebraska. If Nebraska passes an equally strict law, then the spammers will run off to Europe. Except wait-a-minute — the European Union already has a strict anti-spam law. Okay then, they’ll set up shop in China and Russia…

But see, the problem with being Shelbyville (oops, I mean China and Russia) is the following: once the majority of people recognize a problem and start to agree on legislation for solving it, they tend to get annoyed with groups of people who don’t follow suit. And ve hav vays uv making you follow suit. In the world of Springfield and Shelbyville, this means honking and giving the finger to Shelbyville drivers as you pass them. In the world of international relations, it means something else, like angry communiques and threats of trade sanctions. If you want to participate fully in the world economy, the other countries have mechanisms for applying pressure until you bring yourself up to international standards. True, these mechanisms are slow and imperfect. But the issue in this case is whether such laws can spread fast enough to prevent email as a mode of communication from melting down completely. The issue certainly isn’t about whether we should waste our time dithering and whinging and making excuses for our own bad behavior.

Of course the main hole in the international-pressure strategy would be countries that have zero interest in participating in anything, like North Korea. Well, that’s North Korea for you. Seriously, if all the spammers flee to North Korea, good riddance. Plus, think about it: wouldn’t you rather North Korea based its economy on spamming than on global extortion and the manufacture of weapons-grade plutonium for sale? Seems like a good trade to me.

Then again, the United States also seems to be immune from this sort of international pressure. So okay, forget what I said above, maybe this strategy isn’t so smart after all. But let’s look at the bright side… won’t it be fun when China and Russia are lecturing us about being the world’s haven for criminal spammers? I, for one, will at least take comfort in the fact that they won’t be over here in California.

1. Probably, assuming I’m disinclined to steal background graphics from lordoftherings.net.