Update .updating.md

Author: vasfvitor

patches/.updating.md

@@ -1,76 +1,81 @@
-## Updating patch
-
-Have starlight version updated on package.json
-Temporarily remove the patch entry from package.json
-
-Run `pnpm i`
-
-place the patch entry back on package.json with the key renamed to $newVersion (keep the older version on the value)
-
-run `pnpm patch @astrojs/starlight@$newVersion`, it will provide a path, copy it as $path
-
-run `pnpm patch-commit $path`
-
-`pnpm dev` and check if blog sidebar still on right order: most recent up top
-
-check live preview
-
-merge
-
----
-
-
-## Fixing patch
-
-### 1. `schemas/sidebar.ts`  
-
-Add `sort` and `order` fields to `AutoSidebarGroupSchema`:  
-
-```ts
-const AutoSidebarGroupSchema = SidebarGroupSchema.extend({
-  autogenerate: z.object({
-    // ...existing fields
-    
-    // fields to add
-    sort: z.enum(['date']).optional(),
-    order: z.enum(['ascending', 'descending']).optional(),
-  }),
-}).strict();
-```
-
-### 2. `utils/navigation.ts`
-
-Extract sort and order from `item.autogenerate`.
-
-```ts find this object
-const { collapsed: subgroupCollapsed, directory } = item.autogenerate;
-```
-
-```ts add 'sort', 'order'
-const { collapsed: subgroupCollapsed, directory, sort, order } = item.autogenerate;
-```
-
-Add sortHandler:  
-
-```ts
-const sortHandler = (kind: 'date', order: 'ascending' | 'descending') => {
-  if (kind === 'date') {
-    return order === 'ascending' 
-      ? (docA: Route, docB: Route) => docA.entry.data.date! > docB.entry.data.date! ? 1 : -1
-      : (docA: Route, docB: Route) => docA.entry.data.date! < docB.entry.data.date! ? 1 : -1;
-  }
-};
-```
-
-Sort dirDocs before calling treeify().
-
-```ts change
-const tree = treeify(dirDocs, localeDir, ...) ;
-```
-
-```ts into this
-const sorted = !sort ? dirDocs : dirDocs.sort(sortHandler(sort, order)).map((doc, i) => { doc.entry.data.sidebar.order = i; return doc; });
-
-const tree = treeify(sorted, localeDir, ...);
-```
-
+## Updating patch
+
+Have Starlight version updated on package.json
+Temporarily remove the patch entry from package.json
+
+Run `pnpm i`
+
+place the patch entry back on package.json with the key renamed to $newVersion (keep the older version on the value)
+
+run `pnpm patch @astrojs/starlight@$newVersion`, it will provide a path, copy it as $path
+
+run `pnpm patch-commit $path`
+
+`pnpm dev` and check if blog sidebar still on right order: most recent up top
+
+check live preview
+
+merge
+
+---
+
+## Manually applying patch in case updating doesn't work
+
+### 1. `schemas/sidebar.ts`
+
+Add `sort` and `order` fields to `AutoSidebarGroupSchema`:
+
+```ts
+const AutoSidebarGroupSchema = SidebarGroupSchema.extend({
+  autogenerate: z.object({
+    // ...existing fields
+
+    // fields to add
+    sort: z.enum(['date']).optional(),
+    order: z.enum(['ascending', 'descending']).optional(),
+  }),
+}).strict();
+```
+
+### 2. `utils/navigation.ts`
+
+Extract sort and order from `item.autogenerate`.
+
+```ts find this object
+const { collapsed: subgroupCollapsed, directory } = item.autogenerate;
+```
+
+```ts add 'sort', 'order'
+const {
+  collapsed: subgroupCollapsed,
+  directory,
+  sort,
+  order,
+} = item.autogenerate;
+```
+
+Add sortHandler:
+
+```ts
+const sortHandler = (kind: 'date', order: 'ascending' | 'descending') => {
+  if (kind === 'date') {
+    return order === 'ascending'
+      ? (docA: Route, docB: Route) =>
+          docA.entry.data.date! > docB.entry.data.date! ? 1 : -1
+      : (docA: Route, docB: Route) =>
+          docA.entry.data.date! < docB.entry.data.date! ? 1 : -1;
+  }
+};
+```
+
+Sort dirDocs before calling treeify().
+
+```ts change
+const tree = treeify(dirDocs, localeDir, ...) ;
+```
+
+```ts into this
+const sorted = !sort ? dirDocs : dirDocs.sort(sortHandler(sort, order)).map((doc, i) => { doc.entry.data.sidebar.order = i; return doc; });
+
+const tree = treeify(sorted, localeDir, ...);
+```