Slight using reorg (quay#1193)

Co-authored-by: Steven Smith <[email protected]>

Author: stevsmit

api/master.adoc

@@ -2,6 +2,7 @@
 include::modules/attributes.adoc[]
 [id="api"]
 = {productname} API guide
+:context: use-api
 
 The {productname} application programming interface (API) provides a comprehensive, RESTful interface for managing and automating tasks within {productname}. Designed around the link:https://oauth.net/2/[_OAuth 2.0 protocol_], this API enables secure, fine-grained access to {productname} resources, and allows administrators and users to perform such actions as creating repositories, managing images, setting permissions, and more. 
 

modules/enabling-using-the-api.adoc

@@ -4,4 +4,17 @@
 
 By leveraging the {productname} API, you can streamline container registry management, automate tasks, and integrate {productname}'s functionalities into your existing workflow. This can improve efficiency, offer enhanced flexibility (by way of repository management, user management, user permissions, image management, and so on), increase the stability of your organization, repository, or overall deployment, and more.
 
-The following sections explain how to enable and use the {productname} API.
+ifeval::["{context}" == "use-quay"]
+Detailed instructions for how to use the {productname} API can be found in the link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index[{productname} API guide]. In that guide, the following topics are covered:
+
+* {productname} token types, including OAuth 2 access tokens, robot account tokens, and OCI referrers tokens, and how to generate these tokens.
+* Enabling the {productname} API by configuring your `config.yaml` file.
+* How to use the {productname} API by passing in your OAuth 2 account token into the desired endpoint. 
+* API examples, including one generic example of how an administrator might automate certain tasks.
+
+See the link:https://docs.redhat.com/en/documentation/red_hat_quay/{producty}/html-single/red_hat_quay_api_guide/index[{productname} API guide] before attempting to use the API endpoints offered in this chapter.
+endif::[]
+
+ifeval::["{context}" == "use-api"]
+The following sections explain how to enable and use the {productname} API.
+endif::[]

use_quay/master.adoc

@@ -17,6 +17,9 @@ The following API endpoints are linked to their associated entry in the link:htt
 //intro and tenancy
 include::modules/user-org-intro.adoc[leveloffset=+1]
 include::modules/tenancy-model.adoc[leveloffset=+2]
+//Red Hat Quay API
+include::modules/enabling-using-the-api.adoc[leveloffset=+1]
+
 //creating and deleting users
 include::modules/user-create.adoc[leveloffset=+1]
 include::modules/creating-user-account-quay-ui.adoc[leveloffset=+2]
@@ -147,18 +150,6 @@ include::modules/build-enhancements.adoc[leveloffset=+1]
 //include::modules/build-limitations.adoc[leveloffset=+2]
 //include::modules/builders-virtual-environment.adoc[leveloffset=+2]
 
-//api
-include::modules/proc_use-api.adoc[leveloffset=+1]
-
-
-
-
-
-
-
-
-
-
 //oci
 include::modules/oci-intro.adoc[leveloffset=+1]
 include::modules/helm-oci-prereqs.adoc[leveloffset=+2]