TechDocs: documentation template (#1954)

* feat(docs-template): Add docs template to create a standalone docs project

* fix(docs-template): add docs template to mock data

* fix(docs-template): owner of template

* add techdocs-ref to cookiecutter docs project

* delete unused cookiecutter json file

* update docs in default index.md file

* rename from .yaml to .yml to be consistent to docs

* update techdocs-ref to use github protocol

plugins/techdocs-backend/src/techdocs/stages/prepare/dir.ts

@@ -43,7 +43,8 @@ export class DirectoryPreparer implements PreparerBase {
 
     const parsedGitLocation = parseGitUrl(target);
     const repositoryTmpPath = path.join(
-      os.tmpdir(),
+      // fs.realpathSync fixes a problem with macOS returning a path that is a symlink
+      fs.realpathSync(os.tmpdir()),
       'backstage-repo',
       parsedGitLocation.source,
       parsedGitLocation.owner,

plugins/techdocs-backend/src/techdocs/stages/prepare/github.ts

@@ -43,7 +43,8 @@ export class GithubPreparer implements PreparerBase {
 
     const parsedGitLocation = parseGitUrl(target);
     const repositoryTmpPath = path.join(
-      os.tmpdir(),
+      // fs.realpathSync fixes a problem with macOS returning a path that is a symlink
+      fs.realpathSync(os.tmpdir()),
       'backstage-repo',
       parsedGitLocation.source,
       parsedGitLocation.owner,