refactor: Walk back making v11 already the default

Author: rschristian

src/assets/_redirects

@@ -1,12 +1,12 @@
-/guide/getting-started /guide/v11/getting-started
-/guide/differences-to-react /guide/v11/differences-to-react
-/guide/switching-to-preact /guide/v11/switching-to-preact
-/guide/types-of-components /guide/v11/components
-/guide/api-reference /guide/v11/api-reference
-/guide/forms /guide/v11/forms
-/guide/linked-state /guide/v8/linked-state
-/guide/external-dom-mutations /guide/v11/external-dom-mutations
+/guide/getting-started /guide/v10/getting-started
+/guide/differences-to-react /guide/v10/differences-to-react
+/guide/switching-to-preact /guide/v10/switching-to-preact
+/guide/types-of-components /guide/v10/components
+/guide/api-reference /guide/v10/api-reference
+/guide/forms /guide/v10/forms
+/guide/unit-testing-with-enzyme /guide/v10/unit-testing-with-enzyme
+/guide/external-dom-mutations /guide/v8/external-dom-mutations
 /guide/extending-component /guide/v8/extending-component
-/guide/unit-testing-with-enzyme /guide/v11/unit-testing-with-enzyme
+/guide/linked-state /guide/v8/linked-state
 /guide/progressive-web-apps /guide/v8/progressive-web-apps
 /* /404/index.html 404

src/components/controllers/guide-page.jsx

@@ -9,7 +9,7 @@ import { MarkdownRegion } from './markdown-region';
 import Sidebar from '../sidebar';
 import Footer from '../footer/index';
 import { docRoutes } from '../../lib/route-utils';
-import { LATEST_MAJOR } from '../doc-version';
+import { LATEST_MAJOR, PREVIEW_MAJOR } from '../doc-version';
 import style from './style.module.css';
 
 export function GuidePage() {
@@ -56,13 +56,15 @@ function OldDocsWarning() {
 		return null;
 	}
 
+	const outdatedVersion = version !== PREVIEW_MAJOR;
 	const latestExists = config.docs[LATEST_MAJOR].some(section =>
 		section.routes.some(route => route.path === '/' + name)
 	);
 
 	return (
 		<div class={style.stickyWarning}>
-			You are viewing the documentation for an older version of Preact.
+			You are viewing the documentation for an{' '}
+			{outdatedVersion ? 'older' : 'unreleased'} version of Preact.
 			{latestExists ? (
 				<>
 					{' '}
@@ -93,7 +95,11 @@ function UnmaintainedTranslationWarning({ meta }) {
 	const { name, version } = params;
 	const [lang, setLang] = useLanguage();
 
-	if (version !== LATEST_MAJOR || MAINTAINED_LANGUAGES.includes(lang) || meta.isFallback) {
+	if (
+		version !== LATEST_MAJOR ||
+		MAINTAINED_LANGUAGES.includes(lang) ||
+		meta.isFallback
+	) {
 		return null;
 	}
 
@@ -103,10 +109,10 @@ function UnmaintainedTranslationWarning({ meta }) {
 		<div class={style.stickyWarning}>
 			<details>
 				<summary>You are viewing an unmaintained translation</summary>
-
-				Whilst we try to offer these docs in as many languages as possible, we rely upon
-				our community members to help us maintain them. This translation has seen little
-				maintenance in recent months and may have fallen out of sync with the English version.
+				Whilst we try to offer these docs in as many languages as possible, we
+				rely upon our community members to help us maintain them. This
+				translation has seen little maintenance in recent months and may have
+				fallen out of sync with the English version.
 			</details>
 			<div class={style.unmaintaindTranslationLinks}>
 				<a
@@ -115,11 +121,7 @@ function UnmaintainedTranslationWarning({ meta }) {
 				>
 					Switch to the English version
 				</a>
-				<a
-					href={editUrl}
-					target="_blank"
-					rel="noopener noreferrer"
-				>
+				<a href={editUrl} target="_blank" rel="noopener noreferrer">
 					Contribute to this translation
 				</a>
 			</div>

src/components/doc-version/index.jsx

@@ -3,7 +3,8 @@ import { useLocation, useRoute } from 'preact-iso';
 import { docRoutes } from '../../lib/route-utils.js';
 import style from './style.module.css';
 
-export const LATEST_MAJOR = 'v11';
+export const LATEST_MAJOR = 'v10';
+export const PREVIEW_MAJOR = 'v11';
 export const AVAILABLE_DOCS = ['11', '10', '8'];
 
 /**
@@ -30,7 +31,12 @@ export default function DocVersion() {
 			Version:{' '}
 			<select value={version} class={style.select} onChange={onChange}>
 				{AVAILABLE_DOCS.map(v => {
-					const suffix = LATEST_MAJOR.slice(1) == v ? ' (current)' : '';
+					let suffix = '';
+					if (LATEST_MAJOR.slice(1) == v) {
+						suffix = ' (current)';
+					} else if (PREVIEW_MAJOR.slice(1) == v) {
+						suffix = ' (preview)';
+					}
 					return (
 						<option key={v} value={`v${v}`}>
 							{v}.x{suffix}

src/config.json

@@ -115,7 +115,7 @@
 			},
 			"content": "guide",
 			"path": "/guide/:version?/:page?",
-			"href": "/guide/v11/getting-started"
+			"href": "/guide/v10/getting-started"
 		},
 		{
 			"name": {

src/lib/page-title.js

@@ -7,11 +7,12 @@ export function createTitle(title) {
 	// Titles for various content areas
 	let suffix = '';
 	switch (true) {
-		case url.startsWith('/guide/v11'):
+		case url.startsWith('/guide/v10'):
 			suffix = 'Preact Guide';
 			break;
-		case url.startsWith('/guide/v10'):
-			suffix = 'Preact Guide v10';
+		// TODO v11: Switch when v11 is properly released
+		case url.startsWith('/guide/v11'):
+			suffix = 'Preact Guide v11';
 			break;
 		case url.startsWith('/guide/v8'):
 			suffix = 'Preact Guide v8';

src/style/markdown.css

@@ -375,8 +375,10 @@
 			scroll-margin-top: var(--header-height);
 		}
 
-		content-region[name*='v8'] &,
-		content-region[name*='v10'] & {
+		/* TODO v11: Switch when v11 is properly released */
+		content-region[name*='v8'] & {
+			/*content-region[name*='v8'] &,
+		content-region[name*='v10'] & {*/
 			scroll-margin-top: calc(var(--header-and-banner-height) + 3.25rem);
 
 			@media (max-height: 431px) {