Probably the builder_example repo should be included in this repo under a docs/example directory or something like this.
I don't think it's a good idea to split the docs from the code.