Function buildCommandDoc

scripts/docs/src/generate-cli-docs.ts:513–546

(
  command: Command,
  rootName: string,
  options?: BuildCommandDocOptions,
)

};

function buildCommandDoc(
  command: Command,
  rootName: string,
  options?: BuildCommandDocOptions,
): CommandDoc {
  const useRootIntro = options?.useRootIntro ?? true;
  const commandPath = getCommandPath(rootName, [], command);
  const title = commandPath;
  const subtitle = `CLI reference docs for ${command.name()} command`;
  const root: Root = {
    type: "root",
    children: buildCommandSection({
      command,
      rootName,
      ancestors: [],
      depth: 2,
      useRootIntro,
    }),
  };

  const markdown = toMarkdown(root);
  const frontmatter = [
    FRONTMATTER_DELIMITER,
    `title: ${formatYamlValue(title)}`,
    `subtitle: ${formatYamlValue(subtitle)}`,
    FRONTMATTER_DELIMITER,
    "",
  ].join("\n");

  const mdx = `${frontmatter}${markdown}\n`;
  const fileName = `${slugifyCommandName(command.name())}.mdx`;

  return { fileName, markdown, mdx, commandPath };
}

function buildIndexDoc(commands: Command[], rootName: string): CommandDoc {
  const root: Root = {