Combine the manual and docs into one place

apps/web/next.config.ts

@@ -72,6 +72,13 @@ const nextConfig: NextConfig = {
     unoptimized: true,
   },
   poweredByHeader: false,
+  async redirects() {
+    // The manual's content now lives in the docs as the pseudocode reference.
+    return ["/manual", "/app/manual"].flatMap((source) => [
+      { source, destination: "/docs", permanent: true },
+      { source: `/:locale(en|zh)${source}`, destination: "/:locale/docs", permanent: true },
+    ]);
+  },
   async headers() {
     const immutableAssetHeaders = [
       {

apps/web/src/app/[locale]/(public)/docs/[slug]/page.tsx

@@ -4,7 +4,7 @@ import { ContentArticle } from "@/app/components/docs/ContentArticle";
 import { localePath, pageMetadata } from "@/i18n/config";
 import { getDictionary } from "@/i18n/messages";
 import { resolveLocale } from "@/i18n/server";
-import { docs, docPath, getDoc } from "@/lib/docs";
+import { docs, docPath, getDoc, isGuide } from "@/lib/docs";
 
 type PageProps = { params: Promise<{ locale: string; slug: string }> };
 
@@ -26,6 +26,6 @@ export default async function DocPage({ params }: PageProps) {
   const { slug } = await params;
   const doc = getDoc(locale, slug);
   if (!doc) notFound();
-  if (doc.unit !== "pseudoeditor") permanentRedirect(localePath(locale, docPath(doc)));
+  if (!isGuide(doc)) permanentRedirect(localePath(locale, docPath(doc)));
   return <ContentArticle locale={locale} doc={doc} />;
 }

apps/web/src/app/[locale]/(public)/docs/page.tsx

@@ -6,7 +6,7 @@ import { PublicListLink, publicListClassName } from "@/app/components/PublicUi";
 import { localePath, localeTags, localeUrl, pageMetadata } from "@/i18n/config";
 import { getDictionary } from "@/i18n/messages";
 import { resolveLocale, type LocaleParams } from "@/i18n/server";
-import { docPath, getGuides } from "@/lib/docs";
+import { docPath, getGuides, getUnit, guideUnitIds } from "@/lib/docs";
 
 export async function generateMetadata({ params }: LocaleParams): Promise<Metadata> {
   const locale = await resolveLocale(params);
@@ -60,14 +60,20 @@ export default async function DocsIndexPage({ params }: LocaleParams) {
         </div>
       </section>
 
-      <section className="site-wrap pb-16">
-        <h2 className="site-h2">{t.guidesTitle}</h2>
-        <div className={`mt-6 ${publicListClassName}`}>
-          {guides.map((doc) => (
-            <PublicListLink key={doc.slug} href={href(docPath(doc))} title={doc.title} description={doc.description} />
-          ))}
-        </div>
-      </section>
+      {guideUnitIds.map((id) => {
+        const unit = getUnit(locale, id);
+        return (
+          <section key={id} id={id} className="site-wrap scroll-mt-20 pb-16">
+            <h2 className="site-h2">{unit.title}</h2>
+            <p className="mt-3 max-w-2xl text-sm leading-6 text-[var(--text2)]">{unit.summary}</p>
+            <div className={`mt-6 ${publicListClassName}`}>
+              {guides.filter((doc) => doc.unit === id).map((doc) => (
+                <PublicListLink key={doc.slug} href={href(docPath(doc))} title={doc.title} description={doc.description} />
+              ))}
+            </div>
+          </section>
+        );
+      })}
 
       <section className="site-wrap pb-20">
         <div className="border-t border-[var(--separator)] pt-8">

apps/web/src/app/[locale]/(public)/lessons/[slug]/page.tsx

@@ -4,19 +4,19 @@ import { ContentArticle } from "@/app/components/docs/ContentArticle";
 import { pageMetadata } from "@/i18n/config";
 import { getDictionary } from "@/i18n/messages";
 import { resolveLocale } from "@/i18n/server";
-import { docs, docPath, getDoc } from "@/lib/docs";
+import { docs, docPath, getDoc, isGuide } from "@/lib/docs";
 
 type PageProps = { params: Promise<{ locale: string; slug: string }> };
 
 export function generateStaticParams() {
-  return docs.filter((doc) => doc.unit !== "pseudoeditor").map((doc) => ({ slug: doc.slug }));
+  return docs.filter((doc) => !isGuide(doc)).map((doc) => ({ slug: doc.slug }));
 }
 
 export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
   const locale = await resolveLocale(params);
   const { slug } = await params;
   const doc = getDoc(locale, slug);
-  if (!doc || doc.unit === "pseudoeditor") return {};
+  if (!doc || isGuide(doc)) return {};
   const base = pageMetadata(locale, docPath(doc), doc.title, doc.description, getDictionary(locale).meta.ogImageAlt);
   return { ...base, openGraph: { ...base.openGraph, type: "article", modifiedTime: doc.updated } };
 }
@@ -25,6 +25,6 @@ export default async function LessonPage({ params }: PageProps) {
   const locale = await resolveLocale(params);
   const { slug } = await params;
   const doc = getDoc(locale, slug);
-  if (!doc || doc.unit === "pseudoeditor") notFound();
+  if (!doc || isGuide(doc)) notFound();
   return <ContentArticle locale={locale} doc={doc} />;
 }