[docs] Improve displayed versions (mui#24051)

oliviertassinari · oliviertassinari · commit 7fe8a4254155 · 2020-12-20T21:49:21.000+01:00
diff --git a/docs/pages/versions.js b/docs/pages/versions.js
@@ -33,10 +33,10 @@ async function getBranches() {
 }
 
 Page.getInitialProps = async () => {
-  const FILTERED_BRANCHES = ['latest', 'staging', 'l10n', 'next'];
+  const FILTERED_BRANCHES = ['latest', 'l10n', 'next'];
 
   const branches = await getBranches();
-  let versions = branches.map((n) => n.name);
+  let versions = branches.map((branch) => branch.name);
   versions = versions.filter((value) => FILTERED_BRANCHES.indexOf(value) === -1);
   versions = versions.map((version) => ({
     version,
@@ -56,6 +56,17 @@ Page.getInitialProps = async () => {
   versions = versions.sort((a, b) =>
     formatVersion(b.version).localeCompare(formatVersion(a.version)),
   );
+
+  if (
+    branches.find((branch) => branch.name === 'next') &&
+    !versions.find((version) => /beta|alpha/.test(version.version))
+  ) {
+    versions.unshift({
+      version: `v${Number(versions[0].version[1]) + 1} pre-release`,
+      url: 'https://next.material-ui.com',
+    });
+  }
+
   versions = sortedUniqBy(versions, 'version');
 
   const { demos, docs } = prepareMarkdown({ pageFilename, requireRaw });
diff --git a/docs/src/pages/versions/ReleasedVersions.js b/docs/src/pages/versions/ReleasedVersions.js
@@ -19,7 +19,7 @@ const styles = {
   },
 };
 
-function StableVersions(props) {
+function ReleasedVersions(props) {
   const { classes } = props;
   const { versions } = React.useContext(PageContext);
 
@@ -41,7 +41,8 @@ function StableVersions(props) {
                 </Link>
               </TableCell>
               <TableCell>
-                {doc.version.length >= 6 ? (
+                {doc.version.length >= 6 &&
+                doc.version.indexOf('pre-release') === -1 ? (
                   <Link
                     variant="body2"
                     color="secondary"
@@ -60,8 +61,8 @@ function StableVersions(props) {
   );
 }
 
-StableVersions.propTypes = {
+ReleasedVersions.propTypes = {
   classes: PropTypes.object.isRequired,
 };
 
-export default withStyles(styles)(StableVersions);
+export default withStyles(styles)(ReleasedVersions);
diff --git a/docs/src/pages/versions/versions.md b/docs/src/pages/versions/versions.md
@@ -2,11 +2,11 @@
 
 <p class="description">You can come back to this page and switch the version of the docs you're reading at any time.</p>
 
-## Stable versions
+## Released versions
 
-The most recent version is recommended in production.
+The most recent stable version (✓) is recommended for use in production.
 
-{{"demo": "pages/versions/StableVersions.js", "hideToolbar": true, "bg": "inline"}}
+{{"demo": "pages/versions/ReleasedVersions.js", "hideToolbar": true, "bg": "inline"}}
 
 ## Latest versions
 
