proposal: repackage examples as a top-level dir

[jdef]

Currently the examples for the v0 and v1 APIs live under the api/v0 and api/v1 packages. This proposal would move them OUT of the api tree and into a top-level examples tree. Additionally, the api/v1/lib package would be folded into api/v1 (moving everything from lib up one level, and then remove lib). The example v1 Docker builder would also move to examples. The final structure would resemble something like this:

api/
  v0/
    ...
  v1/
    backoff/
    encoding/
    executor/
    extras/
    ...
    vendor/
examples/
  v0/
    executor/
    flagcheck/
    persistent_scheduler/
    ...
  v1/
    docker/
    example-scheduler/
    example-executor/
    vendor/

/cc @pires

[pires]

This looks great! 👍