Solo una breve nota para comentar un par de cosas aquí:
Primero, sí, ese es el plugin de documentación más nuevo que pretendemos que reemplace al antiguo. Lo estamos usando aquí en meta para nuestra documentación, donde está sirviendo a nuestros propósitos mucho mejor. Te permite definir las secciones y páginas que se muestran en la navegación de la barra lateral en el orden que desees.
Todavía está en fase experimental en el sentido de que no ha alcanzado la madurez que creemos que necesita para ser ampliamente compatible; lo principal que se necesita es una forma más fácil de usar para administrar los índices que respaldan la navegación en la barra lateral.
Espero que en algún momento también admitamos anidaciones más profundas.
No estamos invirtiendo demasiado en el plugin en este preciso momento, pero es la base sobre la cual espero que construiremos más de estas funciones cuando se conviertan en una prioridad y/o en colaboración con socios.