Plugin documentation

I don’t think there is any documentation about how to make a plugin or ever has been and as far as I’m aware there are not even any guidelines how to best go about it. What about learning by studying other peoples code over at http://getkirby-plugins.com ? Maybe not a replacement for docs, but a starting point.