Site-standardize intro page formatting
Serves https://github.com/bazelbuild/bazel/issues/10794
Closes #10828.
PiperOrigin-RevId: 296263464
diff --git a/site/docs/bazel-overview.md b/site/docs/bazel-overview.md
index 3b062ae..6cca1fa 100644
--- a/site/docs/bazel-overview.md
+++ b/site/docs/bazel-overview.md
@@ -1,9 +1,11 @@
---
layout: documentation
-title: Bazel Overview
+title: Bazel overview
---
-# What is Bazel?
+# Bazel overview
+
+## What is Bazel?
Bazel is an open-source build and test tool similar to Make, Maven, and Gradle.
It uses a human-readable, high-level build language. Bazel supports projects in
@@ -11,7 +13,7 @@
large codebases across multiple repositories, and large numbers of users.
-# Why should I use Bazel?
+## Why should I use Bazel?
Bazel offers the following advantages:
@@ -41,7 +43,7 @@
framework.
-# How do I use Bazel?
+## How do I use Bazel?
To build or test a project with Bazel, you typically do the following:
@@ -75,7 +77,7 @@
to trace dependencies in your code.
-# How does Bazel work?
+## How does Bazel work?
When running a build or a test, Bazel does the following:
@@ -96,7 +98,7 @@
and maximizing [reproducibility](guide.html#correctness).
-## What is the action graph?
+### What is the action graph?
The action graph represents the build artifacts, the relationships between them,
and the build actions that Bazel will perform. Thanks to this graph, Bazel can
@@ -106,7 +108,7 @@
easily [trace dependencies](query-how-to.html) in your code.
-# How do I get started?
+## How do I get started?
To get started with Bazel, see [Getting Started](getting-started.html) or jump
directly to the Bazel tutorials: