AAP-33897 Devtools Add scaffolding collections chapter (#2404)

Author: ariordan-redhat

downstream/assemblies/devtools/assembly-devtools-ansible-sign.adoc

@@ -0,0 +1,24 @@
+ifdef::context[:parent-context-of-devtools-ansible-sign: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="devtools-ansible-sign"]
+endif::[]
+ifdef::context[]
+[id="devtools-ansible-sign_{context}"]
+endif::[]
+
+= Working with ansible-sign
+
+:context: devtools-ansible-sign
+
+// You must move roles into collections if you want to use them in {PlatformNameShort}.
+
+Working with ansible-sign
+
+// include::devtools/proc-devtools-zzz.adoc[leveloffset=+1]
+
+ifdef::parent-context-of-devtools-ansible-sign[:context: {parent-context-of-devtools-ansible-sign}]
+ifndef::parent-context-of-devtools-ansible-sign[:!context:]
+

downstream/assemblies/devtools/assembly-devtools-builder.adoc

@@ -0,0 +1,24 @@
+ifdef::context[:parent-context-of-devtools-builder: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="devtools-builder"]
+endif::[]
+ifdef::context[]
+[id="devtools-builder_{context}"]
+endif::[]
+
+= Working with {Builder}
+
+:context: devtools-builder
+
+// You must move roles into collections if you want to use them in {PlatformNameShort}.
+
+Working with {Builder}
+
+// include::devtools/proc-devtools-zzz.adoc[leveloffset=+1]
+
+ifdef::parent-context-of-devtools-builder[:context: {parent-context-of-devtools-builder}]
+ifndef::parent-context-of-devtools-builder[:!context:]
+

downstream/assemblies/devtools/assembly-devtools-create-plugins-collection.adoc

@@ -0,0 +1,25 @@
+ifdef::context[:parent-context-of-devtools-create-plugins-collection: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="devtools-create-plugins-collection"]
+endif::[]
+ifdef::context[]
+[id="devtools-create-plugins-collection_{context}"]
+endif::[]
+
+= Creating a collection for distributing plug-ins and modules
+
+:context: devtools-create-plugins-collection
+
+// You must move roles into collections if you want to use them in {PlatformNameShort}.
+
+include::devtools/con-devtools-plan-plugins-collection.adoc[leveloffset=+1]
+include::devtools/con-devtools-plugins-collection-prerequisites.adoc[leveloffset=+1]
+
+include::devtools/proc-devtools-scaffold-roles-collection.adoc[leveloffset=+1]
+
+ifdef::parent-context-of-devtools-create-plugins-collection[:context: {parent-context-of-devtools-create-plugins-collection}]
+ifndef::parent-context-of-devtools-create-plugins-collection[:!context:]
+

downstream/assemblies/devtools/assembly-devtools-lint.adoc

@@ -0,0 +1,24 @@
+ifdef::context[:parent-context-of-devtools-lint: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="devtools-lint"]
+endif::[]
+ifdef::context[]
+[id="devtools-lint_{context}"]
+endif::[]
+
+= Working with ansible-lint
+
+:context: devtools-lint
+
+// You must move roles into collections if you want to use them in {PlatformNameShort}.
+
+Working with ansible-lint
+
+// include::devtools/proc-devtools-zzz.adoc[leveloffset=+1]
+
+ifdef::parent-context-of-devtools-lint[:context: {parent-context-of-devtools-lint}]
+ifndef::parent-context-of-devtools-lint[:!context:]
+

downstream/assemblies/devtools/assembly-devtools-molecule.adoc

@@ -0,0 +1,24 @@
+ifdef::context[:parent-context-of-devtools-molecule: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="devtools-molecule"]
+endif::[]
+ifdef::context[]
+[id="devtools-molecule_{context}"]
+endif::[]
+
+= Working with Molecule
+
+:context: devtools-molecule
+
+// You must move roles into collections if you want to use them in {PlatformNameShort}.
+
+Working with Molecule
+
+// include::devtools/proc-devtools-zzz.adoc[leveloffset=+1]
+
+ifdef::parent-context-of-devtools-molecule[:context: {parent-context-of-devtools-molecule}]
+ifndef::parent-context-of-devtools-molecule[:!context:]
+

downstream/assemblies/devtools/assembly-devtools-navigator.adoc

@@ -0,0 +1,24 @@
+ifdef::context[:parent-context-of-devtools-navigator: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="devtools-navigator"]
+endif::[]
+ifdef::context[]
+[id="devtools-navigator_{context}"]
+endif::[]
+
+= Working with {Navigator}
+
+:context: devtools-navigator
+
+// You must move roles into collections if you want to use them in {PlatformNameShort}.
+
+Working with {Navigator}
+
+// include::devtools/proc-devtools-zzz.adoc[leveloffset=+1]
+
+ifdef::parent-context-of-devtools-navigator[:context: {parent-context-of-devtools-navigator}]
+ifndef::parent-context-of-devtools-navigator[:!context:]
+

downstream/assemblies/devtools/assembly-devtools-pytest-ansible.adoc

@@ -0,0 +1,24 @@
+ifdef::context[:parent-context-of-devtools-pytest-ansible: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="devtools-pytest-ansible"]
+endif::[]
+ifdef::context[]
+[id="devtools-pytest-ansible_{context}"]
+endif::[]
+
+= Working with pytest-ansible
+
+:context: devtools-pytest-ansible
+
+// You must move roles into collections if you want to use them in {PlatformNameShort}.
+
+Working with pytest-ansible
+
+// include::devtools/proc-devtools-zzz.adoc[leveloffset=+1]
+
+ifdef::parent-context-of-devtools-pytest-ansible[:context: {parent-context-of-devtools-pytest-ansible}]
+ifndef::parent-context-of-devtools-pytest-ansible[:!context:]
+

downstream/assemblies/devtools/assembly-devtools-tox-ansible.adoc

@@ -0,0 +1,24 @@
+ifdef::context[:parent-context-of-devtools-tox-ansible: {context}]
+
+:_mod-docs-content-type: ASSEMBLY
+
+ifndef::context[]
+[id="devtools-tox-ansible"]
+endif::[]
+ifdef::context[]
+[id="devtools-tox-ansible_{context}"]
+endif::[]
+
+= Working with tox-ansible
+
+:context: devtools-tox-ansible
+
+// You must move roles into collections if you want to use them in {PlatformNameShort}.
+
+Working with tox-ansible
+
+// include::devtools/proc-devtools-zzz.adoc[leveloffset=+1]
+
+ifdef::parent-context-of-devtools-tox-ansible[:context: {parent-context-of-devtools-tox-ansible}]
+ifndef::parent-context-of-devtools-tox-ansible[:!context:]
+

downstream/modules/devtools/con-devtools-plan-plugins-collection.adoc

@@ -0,0 +1,7 @@
+:_mod-docs-content-type: CONCEPT
+
+[id="plan-plugins-collection_{context}"]
+= Planning your collection of plugins and modules
+
+// Organize smaller bundles of curated automation into separate collections for specific functions, rather than creating one big general collection for all of your roles.
+

downstream/modules/devtools/con-devtools-plugins-collection-prerequisites.adoc

@@ -0,0 +1,15 @@
+:_mod-docs-content-type: CONCEPT
+
+[id="devtools-plugins-collection-prerequisites_{context}"]
+= Prerequisites
+
+* You have installed {VSCode} and the Ansible extension.
+* You have installed the Microsoft Dev Containers extension in {VSCode}.
+* You have installed {ToolsName}.
+* You have installed a containerization platform, for example Podman, Podman Desktop, Docker, or Docker Desktop.
+* You have a Red Hat account and you can log in to the Red Hat container registry at `registry.redhat.io`.
+For information about logging in to `registry.redhat.io`, see
+xref:devtools-setup-registry-redhat-io_installing-devtools[Authenticating with the Red Hat container registry].
+// * Considerations about environments / isolation (ADE / devcontainer files)
+
+