feat: redirect current version urls (#3680)

Allows our CLI tool to user the latest version in the path, and
gracefully handles this server side:

https://reactnative.dev/docs/0.71/X -> https://reactnative.dev/docs/X

Author: blakef

scripts/update-redirect/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ */
+
+const fs = require('fs');
+const path = require('path');
+const assert = require('assert');
+
+if (process.argv.length < 4) {
+  console.log(
+    `Usage: update-redirect <path to _redirects> <path to versions.json>`
+  );
+  process.exit(1);
+}
+
+const [redirects, versions] = process.argv.slice(2);
+assert.match(
+  redirects,
+  /_redirects$/,
+  'Expects _redirects path as 2nd argument'
+);
+assert.match(
+  versions,
+  /versions.json$/,
+  'Expects versions.jsoon path as 3nd argument'
+);
+
+const latestPublicVersion = JSON.parse(fs.readFileSync(versions, 'utf8'))[0];
+const VERSION_KEY = '$LATEST_VERSION$';
+
+const before = fs.readFileSync(redirects, 'utf8');
+
+if (!before.includes(VERSION_KEY)) {
+  console.warn(
+    `yarn run update-redirect is expecting to find ${VERSION_KEY} in '${redirects}
+
+This is a problem because any direct linking to ${latestPublicVersion} must be redirected:
+- from: https://reactnative.dev/docs/${latestPublicVersion}/...
+- to:   https://reactnative.dev/docs/...
+
+Someone must have committed the _redirects after build.`
+  );
+  process.exit(1);
+}
+
+fs.writeFileSync(redirects, before.replace(VERSION_KEY, latestPublicVersion));
+console.log(
+  `Successfully added direct for /docs/${latestPublicVersion}/* -> /docs/*`
+);

scripts/update-redirect/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "@react-native-website/update-redirects",
+  "version": "0.0.0",
+  "private": true,
+  "bin": {
+    "update-redirect": "./index.js"
+  }
+}

website/package.json

@@ -11,7 +11,7 @@
   },
   "scripts": {
     "start": "docusaurus start",
-    "build": "docusaurus build",
+    "build": "docusaurus build && yarn run update-redirect ./build/_redirects ./versions.json",
     "swizzle": "docusaurus swizzle",
     "deploy": "docusaurus deploy",
     "serve": "docusaurus serve",
@@ -58,6 +58,7 @@
   "devDependencies": {
     "@docusaurus/types": "^2.3.1",
     "@react-native-website/lint-examples": "0.0.0",
+    "@react-native-website/update-redirects": "0.0.0",
     "alex": "^10.0.0",
     "fs-extra": "^10.1.0",
     "glob": "^8.0.3",

website/static/_redirects

@@ -47,4 +47,7 @@
 /docs/0.66/architecture-glossary             /architecture/glossary
 
 # Rework of the community
-/help         /community/overview
+/help         /community/overview
+
+# Latest version might be linked to directly and should redirect
+/docs/$LATEST_VERSION$/*  /docs/:splat