Merge pull request #6639 from backstage/techdocs/ref-follow-ups

[TechDocs] Remove deprecated preparer support and document ref values

plugins/scaffolder-backend/sample-templates/create-react-app/skeleton/catalog-info.yaml

@@ -5,7 +5,7 @@ metadata:
   description: {{cookiecutter.description | jsonify}}
   annotations:
     github.com/project-slug: {{cookiecutter.destination.owner + "/" + cookiecutter.destination.repo}}
-    backstage.io/techdocs-ref: url:{{"https://" + cookiecutter.destination.host + "/" + cookiecutter.destination.owner + "/" + cookiecutter.destination.repo}}
+    backstage.io/techdocs-ref: dir:.
 spec:
   type: website
   lifecycle: experimental

plugins/scaffolder-backend/sample-templates/create-react-app/skeleton/mkdocs.yml

@@ -0,0 +1,8 @@
+site_name: {{cookiecutter.component_id | jsonify}}
+site_description: {{cookiecutter.description | jsonify}}
+
+nav:
+  - Introduction: index.md
+
+plugins:
+  - techdocs-core

plugins/scaffolder-backend/sample-templates/docs-template/skeleton/catalog-info.yaml

@@ -5,7 +5,7 @@ metadata:
   description: {{cookiecutter.description | jsonify}}
   annotations:
     github.com/project-slug: {{cookiecutter.destination.owner + "/" + cookiecutter.destination.repo}}
-    backstage.io/techdocs-ref: url:{{"https://" + cookiecutter.destination.host + "/" + cookiecutter.destination.owner + "/" + cookiecutter.destination.repo}}
+    backstage.io/techdocs-ref: dir:.
 spec:
   type: documentation
   lifecycle: experimental

plugins/scaffolder-backend/sample-templates/react-ssr-template/skeleton/catalog-info.yaml

@@ -5,7 +5,7 @@ metadata:
   description: {{cookiecutter.description | jsonify}}
   annotations:
     github.com/project-slug: {{cookiecutter.destination.owner + "/" + cookiecutter.destination.repo}}
-    backstage.io/techdocs-ref: url:{{"https://" + cookiecutter.destination.host + "/" + cookiecutter.destination.owner + "/" + cookiecutter.destination.repo}}
+    backstage.io/techdocs-ref: dir:.
 spec:
   type: website
   lifecycle: experimental

plugins/scaffolder-backend/sample-templates/springboot-grpc-template/skeleton/catalog-info.yaml

@@ -5,7 +5,7 @@ metadata:
   description: {{cookiecutter.description | jsonify}}
   annotations:
     github.com/project-slug: {{cookiecutter.destination.owner + "/" + cookiecutter.destination.repo}}
-    backstage.io/techdocs-ref: url:{{"https://" + cookiecutter.destination.host + "/" + cookiecutter.destination.owner + "/" + cookiecutter.destination.repo}}
+    backstage.io/techdocs-ref: dir:.
 spec:
   type: service
   lifecycle: experimental

plugins/techdocs-backend/examples/documented-component/catalog-info.yaml

@@ -4,7 +4,7 @@ metadata:
   name: documented-component
   description: A Service with TechDocs documentation
   annotations:
-    backstage.io/techdocs-ref: 'url:https://github.com/backstage/backstage/tree/master/plugins/techdocs-backend/examples/documented-component'
+    backstage.io/techdocs-ref: dir:.
 spec:
   type: service
   lifecycle: experimental