anchor.diff:  == Links, hyperlinks, and cross references
   Links can be used to cross-reference internal topics, or send customers to external information resources for further reading.
   
  -In OpenShift docs
  -* all links to internal topics are created using `xref` and have an anchor id.
  -* all links to external topics are created using `link`.
  +In OpenShift docs:
  +
  +* all links to internal topics are created using `xref` and **must have an anchor ID**.
  +* all links to external websites are created using `link`.
   
   === Internal Cross-References
   Whenever possible the link to another topic should be part of the actual sentence. Avoid creating links as a separate sentence that begins with "See [this topic] for more information on x".
  
positive.code: 
  [NOTE]
  ====
  You must use the .adoc extension in order for the link to work correctly and you must specify an anchor id.
  ====
  
  *Link to a subtopic within a topic file*
  
negative.code: xref:../zag.adoc#baz-zag[comment]
  ----
  
  where `baz-zag` is the anchor ID at the top of the file `zag.adoc`.
  
  *Link to topic in different topic group directory*
  
  