Using Annotations CBA Practice Questions (Page 5)

Questions 21–22

1. 21application · medium

   A development team has registered a component in Backstage. The TechDocs tab shows 'No documentation found' even though the repository contains a 'docs/index.md' file. The entity descriptor includes 'backstage.io/techdocs-ref: dir:.' and 'github.com/project-slug: my-org/my-repo'. What is the most likely reason the documentation is not appearing?

   • AThe 'github.com/project-slug' annotation is misspelled or has the wrong value.
   • BThe 'docs/index.md' file is not in the expected location for the TechDocs builder.
   • CThe TechDocs builder is not configured to use the 'dir:.' reference.
   • DThe entity needs a 'backstage.io/techdocs-ref' annotation with a URL instead of 'dir:.'.
   Reveal Solution Discussion Select an answer first
2. 22application · medium

   A developer is adding an annotation to a catalog entity and writes 'backstage.io/techdocs-ref: url:https://github.com/org/repo/tree/main/docs'. The TechDocs tab shows an error. What is the most likely cause?

   • AThe URL must be a 'dir:' reference.
   • BThe URL points to the GitHub UI, not the raw content.
   • CThe entity needs a 'github.com/project-slug' annotation.
   • DThe annotation key is incorrect.
   Reveal Solution Discussion Select an answer first