Skip to content

Commit 413528d

Browse files
Adding descriptions (#662)
* first batch of descriptions * more descriptions * pre-commit fixes * more descriptions * linter fixes * linter fixes * more descriptions * more descriptions * linter fixes * Add description bit to style guide * Add more descriptions * Add more descriptions * Remove trailing whitespace * Update modules/ROOT/pages/licenses.adoc Co-authored-by: Nick <[email protected]> * Update modules/reference/pages/glossary.adoc Co-authored-by: Nick <[email protected]> * Update modules/reference/pages/duration.adoc Co-authored-by: Nick <[email protected]> * Update modules/guides/pages/viewing-and-verifying-sboms.adoc Co-authored-by: Nick <[email protected]> * Update modules/concepts/pages/s3.adoc Co-authored-by: Nick <[email protected]> * Add info about description usage * Update modules/concepts/pages/tls-server-verification.adoc Co-authored-by: Nick <[email protected]> * Update modules/concepts/pages/stacklet.adoc Co-authored-by: Nick <[email protected]> --------- Co-authored-by: Nick <[email protected]>
1 parent b876795 commit 413528d

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+67
-26
lines changed

modules/ROOT/pages/export.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
= Export Control
2+
:description: Stackable Data Platform is exempt from US EAR export controls due to its publicly available status and use of standard encryption. Code is open source on GitHub.
23

34
== USA
45

modules/ROOT/pages/getting-started.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
= Getting Started
22
:page-aliases: getting_started.adoc
3+
:description: Learn how to set up and test a Stackable Data Platform with Apache ZooKeeper, Kafka, and NiFi using Kubernetes. Ideal for lab environments.
34

45
One of the best ways of getting started with a new platform is to try it out. Any big data platform has a lot of moving parts and getting some hands on keyboard time with it helps reinforce learning.
56

modules/ROOT/pages/index.adoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
= Stackable Documentation
22
:page-layout: landing
3-
43
:k8s-operators: https://kubernetes.io/docs/concepts/extend-kubernetes/operator/
54
:docs-discussion: https://github.com/stackabletech/community/discussions
65
:docs-issues: https://github.com/stackabletech/documentation/issues
76
:docs-repo: https://github.com/stackabletech/documentation
7+
:description: User Documentation for the Stackable Data Platform.
88

99
++++
1010
<style>
@@ -82,7 +82,7 @@ Run a demo data processing pipeline or follow a tutorial to learn about the plat
8282
<h3>Concept explanation</h3>
8383
++++
8484

85-
Read concept explanation to gain a better understanding of how the Stackable Data platform works,
85+
Read concept explanation to gain a better understanding of how the Stackable Data platform works,
8686
or how a specific feature works.
8787

8888
xref:concepts:index.adoc[]

modules/ROOT/pages/kubernetes/index.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
= Kubernetes
2+
:description: Learn how to install Kubernetes for the Stackable Data Platform. Supported production distributions and local setup options with Kind and K3s.
23

34
The Stackable Data Platform runs on Kubernetes, a Kubernetes cluster is a prerequisite to running the platform.
45
On this page you will find information on the supported Kubernetes distributions for production as well as how to set up a local test installation to try out parts of the platform right away.

modules/ROOT/pages/licenses.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
= Licenses for the Stackable Data Platform
2+
:description: Find licenses for all Stackable Data Platform components available on GitHub including operators, stackablectl, and Docker images.
23

34
The Stackable Data Platform is open source, and the source code of all the components can be found on GitHub. Licenses are also provided alongside the source code, in a file called `LICENSE`.
45

modules/ROOT/pages/policies.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
= Lifecycle policies
2+
:description: Detailed lifecycle policies for Stackable Data Platform, covering SDP, CRD versioning, product support, and compatibility with Kubernetes & OpenShift.
23

34
This page details our lifecycle policies around various parts of our product - the Stackable Data Platform (SDP).
45

modules/ROOT/pages/product-information.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
11
= Product information
2+
:description: Learn about concrete specifications of the Stackable Data Platform (SDP) as a product, which components are
3+
included, how they are supplied and which external dependencies exist that you as a customer need to take care of.
24

35
This page contains concrete specifications about the Stackable Data Platform (SDP) as a product, which components are
46
included, how they are supplied and which external dependencies exist that you as a customer need to take care of.

modules/ROOT/pages/quickstart.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
= Quickstart
2-
32
:latest-release: https://github.com/stackabletech/stackable-cockpit/releases/tag/stackablectl-1.0.0-rc2
43
:cockpit-releases: https://github.com/stackabletech/stackable-cockpit/releases
4+
:description: Quickstart guide for Stackable: Install stackablectl, set up a demo, and connect to services like Superset and Trino with easy commands and links.
55

66
This is the super-short getting started guide that should enable you to get something up and running in less than three
77
minutes (excluding download times).

modules/ROOT/pages/release-notes.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
= Release notes for the Stackable Data Platform
22
:page-aliases: release_notes.adoc
3+
:description: Learn about the latest features and changes in the release notes for the Stackable Data Platform.
34

45
The Stackable platform consists of multiple operators that work together. Periodically a platform release is made,
56
including all components of the platform at a specific version.

modules/concepts/pages/authentication.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
= Authentication
22
:keycloak: https://www.keycloak.org/
3+
:description: Overview of Stackable’s user authentication methods and configuration for LDAP, OIDC, TLS, and Static providers.
34

45
The Stackable Platform uses the AuthenticationClass as a central mechanism to handle user authentication across supported products.
56
The authentication mechanism needs to be configured only in the AuthenticationClass which is then referenced in the xref:stacklet.adoc[Stacklet] definition.

0 commit comments

Comments
 (0)