menu.config.ts

/**
 * Menu Order Configuration
 *
 * Define the order of items in the sidebar navigation.
 * Items not listed here will appear at the end in alphabetical order.
 *
 * Structure:
 * - Top-level array defines the order of root items (directories and files)
 * - For directories, use an object with `name` and `children` to define child order
 * - Use string for files or directories without specific child ordering
 *
 * Example:
 * [
 *   "index",              // Root file
 *   "getting-started",    // Root file
 *   {
 *     name: "guides",
 *     children: ["introduction", "advanced"]
 *   },
 *   "reference"           // Directory with default alphabetical child ordering
 * ]
 */

export type MenuOrderItem =
  | string
  | {
      name: string;
      children?: MenuOrderItem[];
    };

export const menuOrder: MenuOrderItem[] = [
  // Introduction first
  "index",

  // Getting started guide
  "getting-started",

  // Guides section
  {
    name: "guides",
    children: ["writing-markdown", "customization", "menu-configuration", "deployment"],
  },

  // Reference section
  {
    name: "reference",
    children: ["keyboard-shortcuts", "faq"],
  },

  // Notes section last
  "notes",
];