update readme

Author: chaance

packages/v1-meta/README.md

@@ -1,17 +1,32 @@
 # V1 Meta
 
 ```tsx
-import { metaV1 } from "@remix-run/v1-meta";
+import { metaV1, getMatchesData } from "@remix-run/v1-meta";
 
-export function meta(args) {
+export const meta = (args) => {
+  // In the v1 API, `meta` received a `parentsData` argument, which is an
+  // object keyed by each parent route ID containing the data returned by
+  // that route's `loader` function. This argument is removed from the
+  // v2 API. `getMatchesData` will construct an object with the same
+  // signature, allowing you to easily refactor your code.
+  let matchesData = getMatchesData(args);
+  let rootData = matchesData["root"];
+
+  // This function will construct an array of `V2_MetaDescriptor` objects.
+  // It will use the same heuristics as Remix v1 to merge the parent
+  // route's meta values with the data you provide.
   return metaV1(args, {
     title: "My App",
     description: "My App Description",
   });
-  //   return [
-  //     { charSet: "utf-8" }, // inherited!
-  //     { title: "My App" },
-  //     { name: "description", content: "My App Description" },
-  //   ];
-}
+
+  // output:
+  return [
+    // This is inherited from the parent route!
+    { charSet: "utf-8" },
+    // If your parent has a title it will be overridden!
+    { title: "My App" },
+    { name: "description", content: "My App Description" },
+  ];
+};
 ```

packages/v1-route-convention/README.md

@@ -4,22 +4,19 @@
 // remix.config.js
 const { createRoutesFromFolders } = require("@remix-run/v1-route-convention");
 
-// tell Remix to ignore everything in the routes directory 
-// we'll let `createRoutesFromFolders` take care of that
-exports.ignoredRouteFiles = ["**/*"];
-exports.routes = (defineRoutes) => createRoutesFromFolders(defineRoutes);
-```
-
-> **Note**
-> If you're already using `ignoredRouteFiles` you can move that to the plugin to keep using it
-
-```diff
-// remix.config.js
-const { createRoutesFromFolders } = require("@remix-run/v1-route-convention");
-
-- exports.ignoredRouteFiles = ["**/.*"];
-+ exports.ignoredRouteFiles = ["**/*"];
-+ exports.routes = (defineRoutes) => createRoutesFromFolders(defineRoutes, { 
-+   ignoredFilePatterns: ["**/.*"] 
-+ });
+/** @type {import('@remix-run/dev').AppConfig} */
+module.exports = {
+  // Tell Remix to ignore everything in the routes directory.
+  // We'll let `createRoutesFromFolders` take care of that.
+  ignoredRouteFiles: ["**/*"],
+  routes: (defineRoutes) => {
+    // `createRoutesFromFolders` will create routes for all files in the
+    // routes directory using the same default conventions as Remix v1.
+    return createRoutesFromFolders(defineRoutes, {
+      // If you're already using `ignoredRouteFiles` in your Remix config,
+      // you can move them to `ignoredFilePatterns` in the plugin's options.
+      ignoredFilePatterns: ["**/.*", "**/*.css"],
+    });
+  },
+};
 ```