Add a design document on a distribution artifact for bazel

With bazel sources depending on checked-in binaries for the
supported platforms, porting bazel to a new platform is hard;
that approach also doesn't scale well if we want to support
users on more platforms.

This design document suggests an alternative approach based
on creating a zip-archive that, besides all sources, also
contains the generated output of the protoc actions. From
this archive, bazel can be bootstrapped without depending
on the right protoc on the target platform.

--
Change-Id: I401452435ed4189ea95260961d981ccc99a98560
Reviewed-on: https://bazel-review.googlesource.com/#/c/6530
MOS_MIGRATED_REVID=135891242
1 file changed
tree: 607d95cc222c08384cadc0c5cc8777a670308618
  1. examples/
  2. scripts/
  3. site/
  4. src/
  5. third_party/
  6. tools/
  7. .gitattributes
  8. .gitignore
  9. AUTHORS
  10. BUILD
  11. CHANGELOG.md
  12. compile.sh
  13. CONTRIBUTING.md
  14. CONTRIBUTORS
  15. LICENSE.txt
  16. README.md
  17. WORKSPACE
README.md

Bazel (Beta)

{Fast, Correct} - Choose two

Bazel is a build tool that builds code quickly and reliably. It is used to build the majority of Google‘s software, and thus it has been designed to handle build problems present in Google’s development environment, including:

  • A massive, shared code repository, in which all software is built from source. Bazel has been built for speed, using both caching and parallelism to achieve this. Bazel is critical to Google's ability to continue to scale its software development practices as the company grows.

  • An emphasis on automated testing and releases. Bazel has been built for correctness and reproducibility, meaning that a build performed on a continuous build machine or in a release pipeline will generate bitwise-identical outputs to those generated on a developer's machine.

  • Language and platform diversity. Bazel's architecture is general enough to support many different programming languages within Google, and can be used to build both client and server software targeting multiple architectures from the same underlying codebase.

Find more background about Bazel in our FAQ.

Getting Started

About the Bazel project: