Skip to content

Commit 9adb066

Browse files
authored
Merge pull request #897 from negz/intro
[v2] Add a "What's Crossplane?" page
2 parents ea173ff + 1d4a2be commit 9adb066

File tree

7 files changed

+269
-368
lines changed

7 files changed

+269
-368
lines changed

content/v2.0-preview/_index.md

Lines changed: 16 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,30 @@
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+
# Using the documentation
1112

12-
Crossplane is an open source Kubernetes extension that transforms your Kubernetes
13-
cluster into a **universal control plane**.
13+
Crossplane organizes its documentation into the following sections:
1414

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.
15+
* [What's Crossplane?]({{<ref "whats-crossplane">}}) introduces Crossplane
16+
and explains why you should use it.
1917

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.
18+
* [Get Started]({{<ref "get-started">}}) explains how to install Crossplane and
19+
create a control plane.
2420

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.
21+
* [Concepts]({{<ref "concepts">}}) introduces Crossplane's key concepts.
2922

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.
23+
* [Guides]({{<ref "guides">}}) guide you through common use cases, like
24+
monitoring Crossplane or extending it by writing a composition function.
3625

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 -->
40-
{{< /hint >}}
26+
* [CLI Reference]({{<ref "cli">}}) documents the `crossplane` command-line
27+
interface that you can use to configure a Crossplane control plane.
4128

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

0 commit comments

Comments
 (0)