Skip to content

Commit a5633a1

Browse files
committed
Remove inline prose about API types in preamble
Considering moving this into the concepts page in a separate PR Signed-off-by: Laura Lorenz <[email protected]>
1 parent 5dd9645 commit a5633a1

File tree

1 file changed

+14
-30
lines changed

1 file changed

+14
-30
lines changed

content/en/docs/tutorials/cluster-management/install-use-dra.md

Lines changed: 14 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -103,9 +103,9 @@ initial state of a cluster with DRA enabled.
103103
No resources found
104104
```
105105

106-
These resources represent a centralized list of the device classes known to
107-
the cluster, each managed by a uniquely named DRA driver. If you set up a new
108-
test cluster for this tutorial, there should be no DeviceClasses.
106+
If you set up a new blank cluster for this tutorial, it's normal to find that
107+
there are no DeviceClasses. [Learn more about DeviceClasses
108+
here.](/docs/concepts/scheduling-eviction/dynamic-resource-allocation/#deviceclass)
109109

110110
2. Get a list of {{< glossary_tooltip text="ResourceSlices" term_id="resourceslice" >}}:
111111

@@ -117,24 +117,9 @@ initial state of a cluster with DRA enabled.
117117
No resources found
118118
```
119119

120-
ResourceSlices represent a partial list of {{< glossary_tooltip
121-
text="infrastructure resources" term_id="infrastructure-resource" >}} that are
122-
potentially available to use from Nodes. The collection of all ResourcesSlices
123-
in the cluster make up the entire set of devices available for dynamic
124-
assignment. Some infrastructure resource types (such as CPU and memory) are
125-
handled through other mechanisms (like [CPU limits and
126-
requests](docs/tasks/configure-pod-container/assign-cpu-resource/)), so they
127-
won't appear in the ResourceSlices. Storage (as in files and block devices) has
128-
its own management mechanism too; see [Storage](/docs/concepts/storage/volumes)
129-
elsewhere in the documentation.
130-
131-
ResourceSlices can represent existing allocated infrastructure, but they can
132-
also represent an offer to provide infrastructure. For example, a specialized
133-
driver can offer a neural networking accelerator ResourceSlice, even though none
134-
of the nodes in the cluster have that kind of accelerator currently attached.
135-
136-
If you set up a new blank cluster for this tutorial, it's normal to find that there
137-
are no ResourceSlices advertised.
120+
If you set up a new blank cluster for this tutorial, it's normal to find that
121+
there are no ResourceSlices advertised. [Learn mroe about ResourceSlices
122+
here.](/docs/concepts/scheduling-eviction/dynamic-resource-allocation/#resourceslice)
138123

139124
1. View {{< glossary_tooltip text="ResourceClaims" term_id="resourceclaim" >}} and {{<
140125
glossary_tooltip text="ResourceClaimTemplates" term_id="resourceclaimtemplate"
@@ -150,16 +135,15 @@ glossary_tooltip text="ResourceClaimTemplates" term_id="resourceclaimtemplate"
150135
No resources found
151136
```
152137

153-
{{< glossary_tooltip text="ResourceClaims" term_id="resourceclaim" >}} and {{<
154-
glossary_tooltip text="ResourceClaimTemplates" term_id="resourceclaimtemplate"
155-
>}} are user-defined objects that encapsulate the requests or requirements of
156-
Pods for different types of specialized devices. These are further described
157-
later, but you can see for now that there are no such objects stored yet as you,
158-
the user, have not created any.
138+
If you set up a new blank cluster for this tutorial, it's normal to find that
139+
there are no ResourceClaims or ResourceClaimTemplates as you, the user, have
140+
not created any. [Learn more about ResourceClaims and ResourceClaimTemplates
141+
here.](/docs/concepts/scheduling-eviction/dynamic-resource-allocation/#resourceclaims-templates)
142+
159143

160-
At this point, you have confirmed that DRA is enabled and configured properly in
161-
the cluster, and that no DRA drivers have advertised any resources to the DRA
162-
APIs yet.
144+
At this point, you have confirmed that DRA is enabled and configured properly in
145+
the cluster, and that no DRA drivers have advertised any resources to the DRA
146+
APIs yet.
163147

164148
## Install an example DRA driver {#install-example-driver}
165149

0 commit comments

Comments
 (0)