The intro page, along with the node.js followup that Severin linked to was my best effort at writing a good entry point
As for hand-crafting a .did file, I’m of two minds on it. It can clean things up nicely, but it’s also technically a new language to work in with limited tooling, so it can be a lot to ask of someone who’s just getting started