Order of documents vary between development and production builds

Bug Report

Describe the bug

The order of the menu is different between the development and production version of the same set of files.

Development Version Production Version

From what I can see, it is based on the file names rather than the order. My file structure looks like but when I change the folder names to be 1-brand and 2-atoms they order correctly. To then get the documents to arrange correctly, I have to do the order ascending (without setting the order: ‘ascending’ option as that does nothing) and then work with it looking strange in the dev version

• OS: OSX 10.3.4
• Node/npm version: 10.1.0/5.6.0

[pedronauck]

Can be a good choice, but I have some points:

• I think that an array of objects can be a better solution in this case
• Import .mdx directly can be bad because we’ll need to transpile they after import to read and this can be a performance leaky

Another solution that I’m thinking about is using an export const instead of a front matter to define document settings, so we can easily import the menu and using on the definition, like that:

// src/components/index.js
export const menu = {
  name: 'Components',
  order: 1
}

// docs/components/Alert.mdx
import { menu } from 'src/components'

export const meta = {
  menu,
  name: 'Alert',
  order: 2,
}

What do you thinking about that @mAAdhaTTah?

[mAAdhaTTah]

Do you have some idea about that feature @mAAdhaTTah ?

I think defining the menu & submenu items via a multi-dimensional array, rather in the front-matter of the pages, would be better. The annoying thing is wanting to rearrange the location of a page on the list and needing to change every single page in order to get it into the right place.

First thought is something like this:

// doczrc.js
export default {
  menu: [
    ["Introduction", ["quickstart", "changelog"]]
    ["Walkthrough", ["setup", "deploying"]]
  ]
};

Even better if we could maybe import the files:

// doczrc.js
import quicksart from './docs/quickstart.mdx';

export default {
  menu: [
    ["Introduction", [quickstart]]
    // etc.
  ]
};

Thoughts?