update docs for nextjs 10.2

app/core/layouts/ContentsLayout.js

@@ -176,7 +176,7 @@ export function ContentsLayout({children, meta, tableOfContents: toc}) {
               <a
                 href={
                   "https://github.com/blitz-js/blitzjs.com/edit/main/app/pages" +
-                  router.asPath +
+                  router.asPath.split("#")[0] +
                   ".mdx"
                 }
                 target="_blank"

app/core/navs/documentation.json

@@ -48,7 +48,6 @@
     },
     "pages": [
       "pages",
-      "redirects",
       "error-pages",
       "head-component",
       "document-component",
@@ -73,6 +72,9 @@
       "link",
       "route-params-query",
       "router",
+      "redirects",
+      "rewrites",
+      "headers",
       "api-routes",
       "shallow-routing",
       "route-manifest"

app/pages/docs/app-component.mdx

@@ -28,4 +28,17 @@ props you send to `Component` will be received by the `page`.
 `pageProps` is an object with the initial props that were preloaded for
 your page by one of our data fetching methods like
 [`getStaticProps`](./get-static-props) or
-[`getServerSideProps`](./get-server-side-props)
+[`getServerSideProps`](./get-server-side-props), otherwise it's an empty
+object.
+
+### Caveats {#caveats}
+
+- Adding a custom `getInitialProps` in your `App` will disable
+  [Automatic Static Optimization](./pages#automatic-static-optimization)
+  in pages without [Static Generation](./get-static-props).
+- When you add `getInitialProps` in your custom app, you must
+  `import App from "blitz"`, call `App.getInitialProps(appContext)` inside
+  `getInitialProps` and merge the returned object into the return value.
+- `App` currently does not support page data fetching methods like
+  [`getStaticProps`](./get-static-props) or
+  [`getServerSideProps`](./get-server-side-props).