Skip to content

Commit 9188eb5

Browse files
committed
Rework the landing page
This tries to: * Modernize how we frame Crossplane * Briefly introduce folks to the docs sections Signed-off-by: Nic Cope <[email protected]>
1 parent cc358cd commit 9188eb5

File tree

1 file changed

+34
-34
lines changed

1 file changed

+34
-34
lines changed

content/v2.0-preview/_index.md

Lines changed: 34 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,51 @@
11
---
2-
title: "Overview"
2+
title: "Welcome"
33
weight: -1
44
cascade:
55
version: "2.0-preview"
66
---
77

8-
{{< img src="/media/banner.png" alt="Crossplane Popsicle Truck" size="large" >}}
8+
Welcome to the Crossplane documentation. Crossplane is a control plane framework
9+
for platform engineering.
910

10-
<br />
11+
Crossplane lets you build control planes to manage your apps, infrastructure, or
12+
anything else. It lets you design the APIs and abstractions that your users use
13+
to interact with your control planes.
1114

12-
Crossplane is an open source Kubernetes extension that transforms your Kubernetes
13-
cluster into a **universal control plane**.
15+
Crossplane has a rich ecosystem of extensions that make building a control plane
16+
faster and easier. It's built on Kubernetes, so it works with all the Kubernetes
17+
tools you already use.
1418

15-
Crossplane lets you manage anything, anywhere, all through standard Kubernetes
16-
APIs. Crossplane can even let you
17-
[order a pizza](https://blog.crossplane.io/providers-101-ordering-pizza-with-kubernetes-and-crossplane/)
18-
directly from Kubernetes. If it has an API, Crossplane can connect to it.
19+
{{< hint "tip" >}}
20+
**A control plane is software that controls other software.**
1921

20-
With Crossplane, platform teams can create new abstractions and custom
21-
APIs with the full power of Kubernetes policies, namespaces, role based access
22-
controls and more. Crossplane brings all your non-Kubernetes resources under
23-
one roof.
22+
Control planes expose an API. You use the API to tell the control plane what
23+
software it should deploy and how - this is your _desired state_. It could be
24+
any cloud native software, like an app, a load balancer, or a GitHub repository.
2425

25-
Custom APIs, created by platform teams, allow security and compliance
26-
enforcement across resources or clouds, without exposing any complexity to the
27-
developers. A single API call can create multiple resources, in multiple clouds
28-
and use Kubernetes as the control plane for everything.
26+
The control plane deploys your software, then monitors it throughout its
27+
lifecycle. If your software ever _drifts_ from your desired state, the control
28+
plane automatically corrects the drift.
2929

30-
{{< hint "tip" >}}
31-
**What's a control plane?**
32-
<!-- vale Google.WordList = NO -->
33-
Control planes create and manage the lifecycle of resources. Control planes
34-
constantly _check_ that the intended resources exist, _report_ when the intended
35-
state doesn't match reality and _act_ to make things right.
36-
37-
Crossplane extends the Kubernetes control plane to be a **universal control
38-
plane** to check, report and act on any resource, anywhere.
39-
<!-- vale Google.WordList = YES -->
30+
Control planes are a core cloud native pattern. The major cloud providers are
31+
all built using control planes.
4032
{{< /hint >}}
4133

4234

43-
# Get started
44-
* [Install Crossplane]({{<ref "get-started/install">}}) in your Kubernetes cluster
45-
* Learn more about how Crossplane works in the
46-
[Crossplane introduction]({{<ref "get-started" >}})
47-
* Join the [Crossplane Slack](https://slack.crossplane.io/) and start a
48-
conversation with a community of over 7,000 operators.
35+
# Using the documentation
36+
37+
Crossplane organizes its documentation into the following sections:
38+
39+
* [Get Started]({{<ref "get-started">}}) explains how to install Crossplane and
40+
create a control plane.
41+
42+
* [Concepts]({{<ref "concepts">}}) introduces Crossplane's key concepts.
43+
44+
* [Guides]({{<ref "guides">}}) guide you through common use cases, like
45+
monitoring Crossplane or extending it by writing a composition function.
4946

47+
* [CLI Reference]({{<ref "cli">}}) documents the `crossplane` command-line
48+
interface that you can use to configure a Crossplane control plane.
5049

51-
Crossplane is a [Cloud Native Compute Foundation](https://www.cncf.io/) project.
50+
* [API Reference]({{<ref "api">}}) documents the APIs that you can use to
51+
configure a Crossplane control plane.

0 commit comments

Comments
 (0)