First pass at a guide to compiler plugins

@steveklabnik, are you interested in looking this over?
Are there issues filed about this hygiene stuff appearing in error messages?