Provisionally update the docs for v17 (#504)

The docs versioning policy for v17 onward is to switch the default docs
version to the newly released major version when we roll it out to Cloud
customers. However, this means that once we release the new major
version, users who visit the tab for that version see a message that the
version is an upcoming release.

This change edits the docs engine to not display the "upcoming release"
message for v17, while keeping v16 as the default docs version. It also
adds an "Edge" submodule for `master`. Since we no longer support v14,
this change removes the v14 submodule.

.gitmodules

@@ -1,7 +1,3 @@
-[submodule "content/14.x"]
-	path = content/14.x
-	url = https://github.com/gravitational/teleport
-	branch = branch/v14
 [submodule "content/15.x"]
 	path = content/15.x
 	url = https://github.com/gravitational/teleport
@@ -13,4 +9,8 @@
 [submodule "content/17.x"]
 	path = content/17.x
 	url = https://github.com/gravitational/teleport
-	branch = master
+	branch = branch/v17
+
+[submodule "content/edge"]
+	path = content/edge
+	url = https://github.com/gravitational/teleport

config.json

@@ -62,7 +62,8 @@
     },
     {
       "name": "14.x",
-      "branch": "branch/v14"
+      "branch": "branch/v14",
+      "deprecated": true
     },
     {
       "name": "15.x",
@@ -75,6 +76,10 @@
     },
     {
       "name": "17.x",
+      "branch": "branch/v17"
+    },
+    {
+      "name": "edge",
       "branch": "master"
     }
   ]

layouts/DocsPage/DocsPage.tsx

@@ -63,7 +63,6 @@ const DocsPage = ({
   const icon = navigation[categoryId]?.icon || "book";
 
   const isOldVersion = available.indexOf(current) < available.indexOf(latest);
-  const isBetaVersion = available.indexOf(current) > available.indexOf(latest);
 
   let path = getPath(latest);
 
@@ -104,7 +103,7 @@ const DocsPage = ({
           )}
           <div className={cn(styles["main-wrapper"], styles[layout])}>
             <div className={styles.main}>
-              {(isOldVersion || isBetaVersion) && (
+              {isOldVersion && (
                 <Notice type="danger" className={styles.notice}>
                   {isOldVersion && (
                     <>
@@ -113,13 +112,6 @@ const DocsPage = ({
                       version instead.
                     </>
                   )}
-                  {isBetaVersion && (
-                    <>
-                      This chapter covers an upcoming release: {current}. We
-                      recommend the <Link href={`${urlCurrent}`}>latest</Link>{" "}
-                      version instead.
-                    </>
-                  )}
                 </Notice>
               )}
               <VarsProvider>

layouts/DocsPage/Versions.tsx

@@ -7,6 +7,9 @@ import styles from "./Versions.module.css";
 
 // renders strikethrough for deprecated versions
 const renderVersion = (version: VersionsDropdown) => {
+  if (version.value === "edge") {
+    return "Edge version";
+  }
   if (version.deprecated) return <s>Version {version.value}</s>;
 
   if (version.value === "Older Versions") return version.value;
@@ -25,6 +28,10 @@ const validVersion = (thisVersion: string, latestVersion: string) => {
   const currentMajorVersion = majorVersionRe.exec(thisVersion);
   const latestMajorVersion = majorVersionRe.exec(latestVersion);
 
+  if (thisVersion === "edge") {
+    return true;
+  }
+
   // Can't calculate validity, so the version is invalid. This happens, e.g.,
   // if we're dealing with a dropdown option like "Older Versions".
   if (currentMajorVersion == null || latestMajorVersion == null) {