anchor.diff:  = Basic CLI commands
   ----
   
  +== Text snippet file metadata
  +Every text snippet should be placed in the snippets folder and should contain the following metadata at the top:
  +
  +----
  +// Text snippet included in the following assemblies: <1>
  +//
  +// * list of assemblies where this text snippet is included
  +//
  +// Text snippet included in the following modules:    <2>
  +//
  +// * list of modules where this text snippet is included
  +----
  +<1> List of assemblies in which this text snippet is included.
  +<2> List of modules in which this text snippet is included.
  +
  +[NOTE]
  +====
  +An anchor ID and human readable title are not required metadata. This type of component is text only and not intended to be published or cross referenced on its own. See <<writing-text-snippets>>.
  +====
  +
  +Example:
  +
  +----
  +// Text snippet included in the following assemblies:
  +//
  +// * installing/installing_aws/installing-aws-default.adoc
  +// * installing/installing_azure/installing-azure-default.adoc
  +// * installing/installing_gcp/installing-gcp-default.adoc
  +
  +In {product-title} version {product-version}, you can install a cluster on {cloud-provider-first} ({cloud-provider}) that uses the default configuration options.
  +----
  +
   == Assembly/module file names
   
   Try to shorten the file name as much as possible _without_ abbreviating important terms that may cause confusion. For example, the `managing-authorization-policies.adoc` file name would be appropriate for an assembly titled "Managing Authorization Policies".
  
positive.code: ====
  When needed, use `.Prerequisites`, `.Next steps`, or `.Additional resources` syntax to suppress TOC formatting within a module. Do not use `==` syntax for these headings in modules. Because you cannot use the xrefs in modules, if you need to include a link under one of these headings, place the entire subsection in the assembly instead.
  ====
  
  [id="using-conscious-language"]
  == Using conscious language
  
negative.code: 
  * An `images` symbolic link to the top-level `images/` directory
  * A `modules` symbolic link to the top-level `modules/` directory
  * If you are including a text snippet in your modules or assemblies, a `snippets` symbolic link to the top-level `snippets/` directory
  
  If the directory that contains an assembly does not have the `images` symbolic link, any images in that assembly or its modules will not be included properly when building the docs.
  
  