buck2 Documentation

[arlyon]

This is a general tracking issue patching holes in the buck2 documentation regarding background information, general use, rule writing, etc. Some high level goals:

• API docs for the prelude
  • providers
  • rules
• buck2 for bazel users
• glossary
• quick start with and without the prelude
• developer environment setup w/ extensions
• toolchains and toolchain rules

[ndmitchell]

API docs for the prelude and rules are already generated internally, we just need to repeat that process outside. I think the main step there is building/deploying a website.

Buck2 for bazel users would be very helpful.

We have a glossary - let me share it to you.

[aherrmann]

buck2 for bazel users

While reading through the existing Buck2 docs I created a loose collection of things where Buck2 and Bazel differ that may be useful for this.

[pakoito]

I'd be good to have examples of projects and rules other than cpp's. I'm interested in Java in particular, but there could be others :D