diff --git a/docs/modules/user-guide/nav.adoc b/docs/modules/user-guide/nav.adoc index 05318a2b..5f15cdd5 100644 --- a/docs/modules/user-guide/nav.adoc +++ b/docs/modules/user-guide/nav.adoc @@ -31,6 +31,10 @@ * Registry Administrator ** xref:devfile-registry.adoc[] +*** xref:overview-devfile-registry.adoc[] +*** xref:building-custom-devfile-registry.adoc[] +*** xref:deploying-devfile-registry.adoc[] +*** xref:registry-schema.adoc[] * xref:api-reference.adoc[] * xref:devfile-resources.adoc[] diff --git a/docs/modules/user-guide/pages/devfile-registry.adoc b/docs/modules/user-guide/pages/overview-devfile-registry.adoc similarity index 75% rename from docs/modules/user-guide/pages/devfile-registry.adoc rename to docs/modules/user-guide/pages/overview-devfile-registry.adoc index 3352c82e..ee745cb6 100644 --- a/docs/modules/user-guide/pages/devfile-registry.adoc +++ b/docs/modules/user-guide/pages/overview-devfile-registry.adoc @@ -1,5 +1,5 @@ :description: Devfile Registry -:navtitle: Devfile registry +:navtitle: Devfile registry overview :keywords: devfile // :page-aliases: diff --git a/docs/modules/user-guide/partials/assembly_devfile-registry.adoc b/docs/modules/user-guide/partials/assembly_devfile-registry.adoc new file mode 100644 index 00000000..1222f7b2 --- /dev/null +++ b/docs/modules/user-guide/partials/assembly_devfile-registry.adoc @@ -0,0 +1,21 @@ +ifdef::context[:parent-context-of-assembly_devfile-registry: {context}] + + +ifndef::context[] +[id="assembly_devfile-registry"] +endif::[] +ifdef::context[] +[id="assembly_devfile-registry_{context}"] +endif::[] += Devfile Registry + +:context: assembly_devfile-registry + + +[role="_abstract"] +Get started with devfile registries: + +* xref:overview-devfile-registry.adoc[] +* xref:building-custom-devfile-registry.adoc[] +* xref:deploying-devfile-registry.adoc[] +* xref:registry-schema.adoc[] diff --git a/docs/modules/user-guide/partials/con_devfile-registry.adoc b/docs/modules/user-guide/partials/con_devfile-registry.adoc index 1392b10b..348096cd 100644 --- a/docs/modules/user-guide/partials/con_devfile-registry.adoc +++ b/docs/modules/user-guide/partials/con_devfile-registry.adoc @@ -1,5 +1,5 @@ -[id="devfile-registry_{context}"] -= Devfile registry +[id="overview-devfile-registry_{context}"] += Overview of devfile registry [role="_abstract"] A devfile registry is a service that stores and provides devfile stacks to Kubernetes developer tools like odo, Eclipse Che, and the OpenShift Developer Console. Therefore, you can access devfiles through the devfile registry. Devfile registries are based on the Oracle Cloud Infrastructure (OCI) Specification, and devfile stacks are stored as OCI-artifacts in the registry. @@ -45,4 +45,4 @@ The on-cluster devfile registries can be configured with custom devfile stacks s == Additional resources -* xref:authoring-stacks.adoc[]. +* xref:building-custom-devfile-registry.adoc[].