Merge pull request #10175 from backstage/rugvip/release-notes

microsite: add release notes section

microsite/pages/en/index.js

@@ -21,16 +21,12 @@ class Index extends React.Component {
     return (
       <main className="MainContent">
         <Banner.Container>
-          <Banner.Dismissable storageKey="2021-10-07-software-templates-techdocs-beta">
-            🚀 Feature updates!{' '}
-            <a href="https://backstage.io/blog/2021/07/26/software-templates-are-now-in-beta">
-              Software Templates
-            </a>{' '}
-            and{' '}
-            <a href="https://backstage.io/blog/2021/09/16/the-techdocs-beta-has-landed">
-              TechDocs
-            </a>{' '}
-            are now in beta.
+          <Banner.Dismissable storageKey="2022-03-16-newsletter-cta">
+            🗞️ Want to stay up to date with Backstage? Sign up for our{' '}
+            <a href="https://mailchi.mp/spotify/backstage-community">
+              Newsletter
+            </a>
+            !
           </Banner.Dismissable>
         </Banner.Container>
 

microsite/sidebars.json

@@ -1,4 +1,7 @@
 {
+  "releases": {
+    "Release Notes": ["releases/v1.0.0"]
+  },
   "docs": {
     "Overview": [
       "overview/what-is-backstage",

microsite/siteConfig.js

@@ -8,6 +8,23 @@
 // See https://docusaurus.io/docs/site-config for all the possible
 // site configuration options.
 
+// This figures out what the most recent release version is, so that we can link to it in the header
+const [{ name: latestRelease }] = require('fs')
+  .readdirSync(require('path').resolve(__dirname, '../docs/releases'))
+  .map(file => {
+    const match = file.match(/^v(\d+)\.(\d+)\.(\d+)\.md$/);
+    if (!match) {
+      return undefined;
+    }
+    const parts = match.slice(1).map(v => parseInt(v, 10));
+    return {
+      name: file.slice(0, file.length - '.md'.length),
+      weight: parts[0] * 1000000 + parts[1] * 1000 + parts[2],
+    };
+  })
+  .filter(Boolean)
+  .sort((a, b) => b.weight - a.weight);
+
 const siteConfig = {
   title: 'Backstage Software Catalog and Developer Platform', // Title for your website.
   tagline: 'An open platform for building developer portals',
@@ -45,12 +62,13 @@ const siteConfig = {
       label: 'Blog',
     },
     {
-      page: 'demos',
-      label: 'Demos',
+      doc: `releases/${latestRelease}`,
+      href: '/releases',
+      label: 'Releases',
     },
     {
-      href: 'https://mailchi.mp/spotify/backstage-community',
-      label: 'Newsletter',
+      page: 'demos',
+      label: 'Demos',
     },
   ],
 

microsite/static/css/custom.css

@@ -1073,11 +1073,13 @@ code {
 .Banner {
   position: relative;
   padding: 14px;
+  padding-right: 50px; /* space for the dismiss button */
   margin: 14px 20px;
   border-radius: 4px;
   background-color: $primaryColor;
   font-family: Helvetica Neue, sans-serif;
   color: #000;
+  display: inline-block;
 }
 
 .Banner--hidden {