Document extensions and include more examples

[technicalpickles]

We use a ton of extensions, and buildkite-builder builds itself using extensions. It's not really documented though.

The main points to cover are:

• dsl for extending the pipeline API
• prepare which is called when it is used
• build which is called ???