Status-Q

Tilly and I had a lovely early walk at Wimpole Hall today. But we weren't alone...

As the poet said,

Bliss was it in that dawn to be alive
But to be young, with four legs and a waggy tail, was very heaven.

A couple of nice quotes from this talk by Nicolas Lara on how his company, Lincoln Loop, works (and thrives) despite being small, globally-distributed, and with employees working from home.

This one, I think, is particularly true:

It's hard to do a really good job on anything you don't think about in the shower.

- Paul Graham

and, on maintaining a healthy work-life balance:

Every one of us has learned how to send emails on Sunday night. But how many of us know how to go to a movie at 2pm on Mondays? You've unbalanced your life without balancing it with something else.

-Ricardo Semler

It's an interesting talk. I remember a Lullabot podcast from about 18 months ago about how they managed a rather larger but similarly-distributed organisation. Lincoln Loop, though, is not just a distributed company with flexible working hours - it's one where the finances are open, and where employees, based on their knowledge of how the company is doing, get to choose their own salaries. An interesting concept to ponder.

Or you could always ask Dolly about the more traditional model...

Quote:

The only example of a wiki that worked is Wikipedia, and that's not really a wiki in the true sense, because it is heavily edited by such a small number of people.

That's Russell Keith-Magee, speaking on a podcast (so I may not have quoted him exactly). He was talking particularly in the context of software documentation, but I think, on consideration, that he's right.

Don't get me wrong, I love wikis, use them quite a bit, and shook Ward Cunningham's hand very enthusiastically when I met him a few years ago. But on the other hand, if one has been spoiled by the quality of documentation in projects such as Django, it makes one's heart sink when exploring a new piece of software to discover that the documentation is 'only a wiki'.

Wikis are great for their free-form, collaborative nature - remember, they came into existence long before Google docs and SubEthaEdit - but they also suffer from a few key problems:

• They can make you feel as if you've done something about documentation, so you don't do the real work. "The crowd will fix it later".
• The fact that you don't need to think about the structure early on means they often need to be reorganised - making it hard for others to find things even if they've visited before, and harder to link to things reliably.
• It's notoriously difficult to move content from a wiki into anything else, including another wiki package.
• It can be hard, with a software package, to know to which version the documentation applies.
• As with mind-maps, the free-form nature closely represents the mental model of the author. It's good for personal notes and reference (Voodoopad is lovely, for example), but the difference between structured documentation and a wiki is the difference between a talk/lecture and a rambling conversation. The letter may be more fun, but does it achieve as much in the same amount of time?

None of this means, of course, that you can't write good documentation with a wiki. It's just very rarely done, and when it is done, it probably takes a lot of effort. Wikis are the whiteboard doodle, the back-of-the-envelope scribble: they can be useful within a small internal group of collaborators, but they're not the thing you want to present to the world.

Actually, I think one of the best ways of doing documentation was the approach adopted by the PHP developers many, many years ago - you write proper docs but allow comments at the bottom of each page. Here's an example. They did this long before the concept of comments-at-the-bottom-of-the-page was well established.

What do you think?

It was a moist early morning... but the light felt almost like a Constable painting.

Tilly enjoyed it, and showed some reluctance to get into the hay wain and head home...

The second-best camera is the one you have with you.
The best is the one you have in your hand.

I like this one - somehow I feel there ought to be an interesting story behind this street in Orwell...

The new Materials Science and Metallurgy building, Cambridge.

This was a lovely story, featured on the BBC this morning. A Russian man, before signing a contract with his bank, altered the small print, signed it, and sent it back to them. They signed it, not noticing that they were then obliged to provide interest-free loans, no management charges, and would pay a substantial penalty if they wished to get out of the contract...

Fabulous idea.

I've done nothing as cunning as that, but often when I call some institution and get an automated voice saying "This call may be recorded...", I say "Thank you!", and click the record button...

That'll show 'em.

About three weeks ago, my very good friends Sarah and Hubertus got married in Queens' College here in Cambridge. They were good enough, and foolhardy enough, to ask me to take the photos.

It was a wonderful occasion - great people, lovely weather, delicious food, and a really excellent ceilidh band in the evening.

Being 'the photographer' was a great learning experience for me, and gave me a huge respect for the professionals who do this on a regular basis.

In particular, at this (otherwise wonderful) venue, every single room had challenges from a lighting point of view. One was very dark, one had a low white ceiling, and one was lined with glass-fronted bookcases, which made it a real challenge to position the flashguns! But things mostly worked out in the end.

Even the outdoor shots had to be carefully managed so people weren't squinting into the bright sunshine, and despite visiting beforehand and working out where the sun would be at about the time the ceremony was finished, I didn't quite get it right. The bride and groom may hope for glorious sunshine on their wedding day, but, trust me, the photographer doesn't!

Still, everyone was very tolerant of the inexpert photographer, and, above all, we all came away with happy memories of a very cheery occasion.

More photos from the wedding can be found here.

I always enjoy Jeff Cable's photography tutorials. Here's a good talk to recommend if you know somebody who has just got a DSLR, or is wondering about getting one. What kind of things can you do with it, and what do you need to know about it, if you're used to a fully-automatic point-and-shoot?

Remember that these days you may need to click the 'YouTube' logo and watch it there if you want to do so in full-screen mode.