DDF-2892 added template for appendix to docs (#2226)

distribution/docs/src/main/jdocs/content/_appendix-intros/dependency-list-intro-contents.adoc

@@ -0,0 +1,8 @@
+:title: Dependency List
+:type: appendixIntro
+:status: published
+:children: ${branding} Dependency List
+:order: 02
+:summary: Introduction to dependency list appendix.
+
+This list of ${branding} dependencies is automatically generated:

distribution/docs/src/main/jdocs/content/_appendix-intros/metadata-attributes-intro-contents.adoc

@@ -0,0 +1,10 @@
+:title: Metadata Attributes
+:type: appendixIntro
+:status: published
+:children: Metadata Attributes, Catalog Taxonomy, All Formats Supported
+:order: 01
+:summary: Introduction to metadata attributes.
+
+${branding} extracts basic metadata from the resources ingested. Many file types and contain additional <<_format_specific_attribute_mappings,format-specific metadata attributes>>.
+A neutral <<_catalog_taxonomy,Catalog Taxonomy>> enables transformation of metadata to other formats.
+See also a <<supported_file_types,list of all formats supported>> for ingest.

distribution/docs/src/main/jdocs/content/_appendix-intros/whitelist-intro-contents.adoc

@@ -0,0 +1,8 @@
+:title: Application Whitelists
+:type: appendixIntro
+:status: published
+:children: Application Whitelists
+:order: 00
+:summary: Introduction to application whitelists.
+
+Within each ${branding} application, certain packages are exported for use by third parties.

distribution/docs/src/main/jdocs/content/_data/data-intro-contents.adoc

@@ -197,6 +197,12 @@ Only these attribute formats may be used.
 
 |===
 
+====== Attribute Naming Conventions
+
+Catalog taxonomy elements follow the naming convention of `group-or-namespace.specific-term`, except for extension fields outside of the core taxonomy.
+These follow the naming convention of `ext.group-or-namespace.specific-term` and must be namespaced.
+Nesting is not permitted.
+
 ===== Result
 
 A single "hit" included in a query response.

distribution/docs/src/main/jdocs/content/_metadata-attributes/associations-attributes-table-contents.adoc

@@ -0,0 +1,36 @@
+:title: Associations
+:type: subappendix
+:parent: Catalog Taxonomy
+:status: published
+:summary: Attributes in this group represent associations between products.
+
+.[[_associations_attributes_table]]Associations: Attributes in this group represent associations between products.
+[cols="1,2,1,1,1" options="header"]
+|===
+
+|Term
+|Definition
+|Datatype
+|Constraints
+|Example Value
+
+|metacard.associations.derived
+|ID of one or more metacards derived from this metacard.
+|List of Strings
+|A valid metacard ID (conventionally, a type 4 random UUID with hyphens removed).
+|70809f17782c42b8ba15747b86b50ebf
+
+|metacard.associations.related
+|ID of one or more metacards related to this metacard.
+|List of Strings
+|A valid metacard ID (conventionally, a type 4 random UUID with hyphens removed).
+|70809f17782c42b8ba15747b86b50ebf
+
+|associations.external
+|One or more URI's identifying external associated
+resources.
+|List of Strings
+|A valid URI.
+|https://infocorp.org/wikia/reference
+
+|===

distribution/docs/src/main/jdocs/content/_metadata-attributes/catalog-taxonomy-intro-contents.adoc

@@ -0,0 +1,14 @@
+:title: Catalog Taxonomy
+:type: appendix
+:status: published
+:parent: Metadata Attributes
+:children: Catalog Taxonomy
+:order: 02
+:summary: Introduction to catalog taxonomy appendix.
+
+To facilitate data sharing while maximizing the usefulness of metadata, the attributes on resources are normalized into a common taxonomy that maps to attributes in the desired output format.
+
+[NOTE]
+====
+The taxonomy is presented here for reference only.
+====