Skip to content

Commit 1b5a789

Browse files
committed
nits for quickstart document
1 parent 9ba71d6 commit 1b5a789

File tree

1 file changed

+17
-4
lines changed

1 file changed

+17
-4
lines changed

docs/content/setup/quickstart.md

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,16 @@
11
---
22
description: >
3-
Get started with kcp by running it locally.
3+
Get started with kcp by running it locally and understanding its role as a platform-building framework.
44
---
55

66
# Quickstart
77

8+
## What is kcp?
9+
10+
kcp is not a platform you can simply pick up and use immediately. Instead, it's a framework for building platforms. As Kelsey Hightower noted in 2017, Kubernetes itself is not a platform but rather a better way to start building one. kcp extends this philosophy further by providing a foundation for creating multi-tenant, workspace-based platforms.
11+
12+
Think of kcp as the infrastructure layer that provides core abstractions and services for building cloud-native application platforms. This quickstart will help you run kcp locally and explore its foundational capabilities, but building a complete platform on top of kcp requires additional design, development, and configuration tailored to your specific needs.
13+
814
## Prerequisites
915

1016
- [kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
@@ -43,10 +49,17 @@ Server Version: v1.32.3+kcp-v0.28.0
4349

4450
## Next steps
4551

46-
Thanks for checking out our quickstart!
52+
Congratulations on successfully running kcp! You've now experienced the basic mechanics of starting and connecting to kcp. However, remember that what you've run is the foundational layer for building platforms, not an end-user platform itself.
53+
54+
To understand how to build meaningful platforms with kcp, here are your next steps:
55+
56+
- [kcp Workshop](https://docs.kcp.io/contrib/learning/20250401-kubecon-london/workshop/) - a hands-on workshop that guides you through kcp's core concepts and features, including workspaces, syncers, and creating a provider-consumer architecture. We recommend using `github workspaces` for the best experience and following along with the exercises.
57+
- [api-syncagent quick start](https://docs.kcp.io/api-syncagent/main/getting-started/) - learn how to use the api-syncagent to sync APIs from a kcp workspace to a downstream Kubernetes cluster. This is more advanced than workshop content and assumes familiarity with kcp concepts.
58+
59+
60+
## Building your platform
4761

48-
If you're interested in learning more about all the features kcp has to offer, please check out our additional
49-
documentation:
62+
Remember, kcp provides the building blocks, but you'll need to design and implement the higher-level abstractions that make sense for your users and use cases. To understand how to leverage kcp's capabilities effectively, explore our additional documentation:
5063

5164
- [Concepts](../concepts/index.md) - a high level overview of kcp concepts
5265
- [Workspaces](../concepts/workspaces/index.md) - a more thorough introduction on kcp's workspaces

0 commit comments

Comments
 (0)