diff --git a/advanced.mdx b/advanced.mdx new file mode 100644 index 0000000..3990562 --- /dev/null +++ b/advanced.mdx @@ -0,0 +1,5 @@ +--- +title: Advanced Bazel +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/apis.mdx b/apis.mdx new file mode 100644 index 0000000..9a75528 --- /dev/null +++ b/apis.mdx @@ -0,0 +1,5 @@ +--- +title: Bazel APIs +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/basics.mdx b/basics.mdx new file mode 100644 index 0000000..8f8159c --- /dev/null +++ b/basics.mdx @@ -0,0 +1,5 @@ +--- +title: Bazel Basics +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/build-encyclopedia.mdx b/build-encyclopedia.mdx new file mode 100644 index 0000000..4e91f64 --- /dev/null +++ b/build-encyclopedia.mdx @@ -0,0 +1,5 @@ +--- +title: Build Encyclopedia +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/build-system-basics.mdx b/build-system-basics.mdx new file mode 100644 index 0000000..63c24c1 --- /dev/null +++ b/build-system-basics.mdx @@ -0,0 +1,5 @@ +--- +title: Build System Basics +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/command-line-reference.mdx b/command-line-reference.mdx new file mode 100644 index 0000000..dbe865c --- /dev/null +++ b/command-line-reference.mdx @@ -0,0 +1,5 @@ +--- +title: Command Line Reference +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/concepts.mdx b/concepts.mdx new file mode 100644 index 0000000..1201ea6 --- /dev/null +++ b/concepts.mdx @@ -0,0 +1,5 @@ +--- +title: Bazel Concepts +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/contributing.mdx b/contributing.mdx new file mode 100644 index 0000000..c67bc5a --- /dev/null +++ b/contributing.mdx @@ -0,0 +1,5 @@ +--- +title: Contributing to Bazel +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/distributing-rules.mdx b/distributing-rules.mdx new file mode 100644 index 0000000..6c5c971 --- /dev/null +++ b/distributing-rules.mdx @@ -0,0 +1,5 @@ +--- +title: Distributing Bazel Rules +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/docs.json b/docs.json index 5bc7bf9..3d8e1d7 100644 --- a/docs.json +++ b/docs.json @@ -18,27 +18,125 @@ "tabs": [ { "tab": "About Bazel", - "pages": ["index"] + "groups": [ + { + "group": "Why Bazel?", + "pages": ["why-bazel"] + }, + { + "group": "Build system basics", + "pages": ["build-system-basics"] + } + ] }, { "tab": "Getting started", - "pages": ["index"] + "groups": [ + { + "group": "Install", + "pages": ["install"] + }, + { + "group": "First build tutorials", + "pages": ["first-build-tutorials"] + }, + { + "group": "Concepts", + "pages": ["concepts"] + } + ] }, { "tab": "User guide", - "pages": ["index"] + "groups": [ + { + "group": "Releases", + "pages": ["releases"] + }, + { + "group": "Basics", + "pages": ["basics"] + }, + { + "group": "Advanced", + "pages": ["advanced"] + }, + { + "group": "Remote Execution", + "pages": ["remote-execution"] + }, + { + "group": "Tutorials", + "pages": ["tutorials"] + }, + { + "group": "Migrate", + "pages": ["migrate"] + } + ] }, { "tab": "Reference", - "pages": ["index"] + "groups": [ + { + "group": "Build encyclopedia", + "pages": ["build-encyclopedia"] + }, + { + "group": "Command line reference", + "pages": ["command-line-reference"] + }, + { + "group": "Query Language", + "pages": ["query-language"] + }, + { + "group": "Glossary", + "pages": ["glossary"] + }, + { + "group": "Flag cheatsheet", + "pages": ["flag-cheatsheet"] + } + ] }, { "tab": "Extending", - "pages": ["index"] + "groups": [ + { + "group": "Concepts", + "pages": ["extending-concepts"] + }, + { + "group": "Writing rules", + "pages": ["writing-rules"] + }, + { + "group": "Distributing rules", + "pages": ["distributing-rules"] + }, + { + "group": "APIs", + "pages": ["apis"] + } + ] }, { "tab": "Community", - "pages": ["index"] + "groups": [ + { + "group": "Contributing", + "pages": ["contributing"] + }, + { + "group": "Programs", + "pages": ["programs"] + }, + { + "group": "Getting help", + "pages": ["getting-help"] + } + ] } ] } diff --git a/extending-concepts.mdx b/extending-concepts.mdx new file mode 100644 index 0000000..5c412c5 --- /dev/null +++ b/extending-concepts.mdx @@ -0,0 +1,5 @@ +--- +title: Extending Bazel Concepts +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/first-build-tutorials.mdx b/first-build-tutorials.mdx new file mode 100644 index 0000000..04845a7 --- /dev/null +++ b/first-build-tutorials.mdx @@ -0,0 +1,5 @@ +--- +title: First Build Tutorials +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/flag-cheatsheet.mdx b/flag-cheatsheet.mdx new file mode 100644 index 0000000..7d636da --- /dev/null +++ b/flag-cheatsheet.mdx @@ -0,0 +1,5 @@ +--- +title: Bazel Flag Cheatsheet +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/getting-help.mdx b/getting-help.mdx new file mode 100644 index 0000000..d207fbb --- /dev/null +++ b/getting-help.mdx @@ -0,0 +1,5 @@ +--- +title: Getting Help with Bazel +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/glossary.mdx b/glossary.mdx new file mode 100644 index 0000000..47676db --- /dev/null +++ b/glossary.mdx @@ -0,0 +1,5 @@ +--- +title: Bazel Glossary +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/images/essential_guide.svg b/images/essential_guide.svg new file mode 100644 index 0000000..4ee63ae --- /dev/null +++ b/images/essential_guide.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/images/essential_reference.svg b/images/essential_reference.svg new file mode 100644 index 0000000..4d29a8d --- /dev/null +++ b/images/essential_reference.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/images/essential_start.svg b/images/essential_start.svg new file mode 100644 index 0000000..c8f48f8 --- /dev/null +++ b/images/essential_start.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/images/new_1.svg b/images/new_1.svg new file mode 100644 index 0000000..c4cd9df --- /dev/null +++ b/images/new_1.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/images/new_2.svg b/images/new_2.svg new file mode 100644 index 0000000..c6b7021 --- /dev/null +++ b/images/new_2.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/images/new_3.svg b/images/new_3.svg new file mode 100644 index 0000000..c2afb4a --- /dev/null +++ b/images/new_3.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/images/release_notes.svg b/images/release_notes.svg new file mode 100644 index 0000000..8a2e8b5 --- /dev/null +++ b/images/release_notes.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/index.mdx b/index.mdx index 2319823..53088be 100644 --- a/index.mdx +++ b/index.mdx @@ -1,52 +1,81 @@ --- -title: "{ Fast, Correct } — Choose two" +title: "{ Fast, Correct }: Choose two" description: "From startup to enterprise, choose the Bazel open source project to build and test your multi-language, multi-platform projects." -# mode: center +mode: center --- - -## Setting up - -Get your documentation site up and running in minutes. - - - { Fast, Correct } — Choose two - - -From startup to enterprise, choose the Bazel open source project to build and test your multi-language, multi-platform projects. - -Rebuild only what is necessary. Get fast, incremental builds with Bazel's advanced local and distributed caching, optimized dependency analysis, and parallel execution. +Rebuild only what is necessary. Get fast incremental builds with Bazel's advanced local and distributed caching, optimized dependency analysis, and parallel execution. Build and test using Java, C++, Go, Android, iOS and many other languages and platforms. Bazel runs on Windows, macOS, and Linux. Scale your organization, codebase, and Continuous Integration systems. Bazel handles codebases of any size, whether in multiple repositories or a huge monorepo. Add support for new languages and platforms with Bazel's extension language. Share and re-use language rules written by the growing Bazel community. - \ No newline at end of file + + +Essential Bazel +--------------- +Build and test software of any size, quickly and reliably. Industry leaders like Google, Stripe, and Dropbox trust Bazel to build heavy-duty, mission-critical infrastructure, services, and applications. + + + + +Learn what Bazel is, why it is a good choice for your project, and how you can get started using it quickly. + + +Learn how to use Bazel with documentation and tutorials covering topics from foundational to expert. + + + +Use these resources to efficiently look up the commands, queries, and terminology necessary to working with Bazel. + + + + + + + + +Bazel is always evolving — check the release notes to see what's changed in the latest releases, and how that affects your builds. + + +What's New? +----------- + +Catch up on the latest documentation, community events, and programs. + + + +Read our new public roadmap to see what is coming down the pipeline. + + +Tune in for our new monthly community update livestream. + + +Get started with the Bazel query language with this new guided scenario. + + + + diff --git a/install.mdx b/install.mdx new file mode 100644 index 0000000..98386fd --- /dev/null +++ b/install.mdx @@ -0,0 +1,5 @@ +--- +title: Install Bazel +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/migrate.mdx b/migrate.mdx new file mode 100644 index 0000000..64e86da --- /dev/null +++ b/migrate.mdx @@ -0,0 +1,5 @@ +--- +title: Migrating to Bazel +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/programs.mdx b/programs.mdx new file mode 100644 index 0000000..01c8964 --- /dev/null +++ b/programs.mdx @@ -0,0 +1,5 @@ +--- +title: Bazel Programs +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/query-language.mdx b/query-language.mdx new file mode 100644 index 0000000..d71b010 --- /dev/null +++ b/query-language.mdx @@ -0,0 +1,5 @@ +--- +title: Bazel Query Language +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/releases.mdx b/releases.mdx new file mode 100644 index 0000000..95e8b69 --- /dev/null +++ b/releases.mdx @@ -0,0 +1,5 @@ +--- +title: Bazel Releases +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/remote-execution.mdx b/remote-execution.mdx new file mode 100644 index 0000000..b9ae1c5 --- /dev/null +++ b/remote-execution.mdx @@ -0,0 +1,5 @@ +--- +title: Remote Execution +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/tutorials.mdx b/tutorials.mdx new file mode 100644 index 0000000..a370313 --- /dev/null +++ b/tutorials.mdx @@ -0,0 +1,5 @@ +--- +title: Bazel Tutorials +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/why-bazel.mdx b/why-bazel.mdx new file mode 100644 index 0000000..1e141d0 --- /dev/null +++ b/why-bazel.mdx @@ -0,0 +1,5 @@ +--- +title: Why Bazel? +--- + +*This is a placeholder page for demo purposes. Real content will be added later.* diff --git a/writing-rules.mdx b/writing-rules.mdx new file mode 100644 index 0000000..4a27a5a --- /dev/null +++ b/writing-rules.mdx @@ -0,0 +1,5 @@ +--- +title: Writing Bazel Rules +--- + +*This is a placeholder page for demo purposes. Real content will be added later.*