Updated Documentation in /docs folder (backstage#2439)

* Initial updates

Signed-off-by: Andre Wanlin <[email protected]>

* Further updates

Signed-off-by: Andre Wanlin <[email protected]>

* Improved group owner code

Signed-off-by: Andre Wanlin <[email protected]>

---------

Signed-off-by: Andre Wanlin <[email protected]>

Author: awanlin

docs/README.md

@@ -60,7 +60,7 @@ async function main(args) {
         backendFeatureReport.package = pkg.packageJson.name;
         backendFeatureReport.role = pkgRole;
         backendFeatureReport.readme = `[README](${pkg.packageJson.repository.url}/blob/master/${pkg.packageJson.repository.directory}/README.md)`;
-        const apiReportPath = join(pkg.dir, 'api-report.md');
+        const apiReportPath = join(pkg.dir, 'report.api.md');
         const apiReport = (await fs.readFile(apiReportPath)).toString();
         if (
           apiReport.includes(BACKEND_FEATURE) ||
@@ -70,7 +70,7 @@ async function main(args) {
           backendFeatureReport.alpha = false;
         }
 
-        const apiReportAlphaPath = join(pkg.dir, 'api-report-alpha.md');
+        const apiReportAlphaPath = join(pkg.dir, 'report-alpha.api.md');
         if (fs.existsSync(apiReportAlphaPath)) {
           const apiReportAlpha = (
             await fs.readFile(apiReportAlphaPath)

docs/compatibility/compatibility.md

@@ -58,14 +58,14 @@ async function main(args) {
         frontendFeatureReport.package = pkg.packageJson.name;
         frontendFeatureReport.role = pkgRole;
         frontendFeatureReport.readme = `[README](${pkg.packageJson.repository.url}/blob/master/${pkg.packageJson.repository.directory}/README.md)`;
-        const apiReportPath = join(pkg.dir, 'api-report.md');
+        const apiReportPath = join(pkg.dir, 'report.api.md');
         const apiReport = (await fs.readFile(apiReportPath)).toString();
         if (apiReport.includes(BACKSTAGE_PLUGIN)) {
           frontendFeatureReport.supported = true;
           frontendFeatureReport.alpha = false;
         }
 
-        const apiReportAlphaPath = join(pkg.dir, 'api-report-alpha.md');
+        const apiReportAlphaPath = join(pkg.dir, 'report-alpha.api.md');
         if (fs.existsSync(apiReportAlphaPath)) {
           const apiReportAlpha = (
             await fs.readFile(apiReportAlphaPath)

docs/compatibility/new-backend-system.md

@@ -52,10 +52,12 @@ async function main(args) {
       o => o !== '@backstage/community-plugins-maintainers',
     );
     filteredOwners.forEach((owner, index) => {
-      if (owner === '@backstage/sda-se-reviewers') {
+      if (owner.includes('/')) {
+        const org = owner.substring(1, owner.indexOf('/'));
+        const team = owner.substring(owner.indexOf('/') + 1);
         filteredOwners[
           index
-        ] = `[@backstage/sda-se-reviewers](https://github.com/orgs/backstage/teams/sda-se-reviewers)`;
+        ] = `[${owner}](https://github.com/orgs/${org}/teams/${team})`;
       } else {
         filteredOwners[
           index