There's a new effort underway to add tutorials to the Rails API documentation. Here's the first draft of a tutorial I just wrote describing how to create plugins.