Apenas uma breve nota para comentar algumas coisas aqui:
Primeiro, sim, esse é o plugin de documentação mais novo que pretendemos substituir o antigo. Estamos usando-o aqui no meta para nossa documentação, onde ele está servindo muito melhor aos nossos propósitos. Ele permite que você defina as seções e páginas que aparecem na navegação da barra lateral na ordem que desejar.
Ele ainda está em experimental no sentido de que ainda não atingiu a maturidade que achamos que ele precisa para ser amplamente suportado - a principal coisa que é necessária é uma maneira mais amigável de gerenciar os índices que suportam a navegação na barra lateral.
O suporte a aninhamento mais profundo é algo que esperamos fazer em algum momento também.
Não estamos investindo muito pesadamente no plugin neste exato momento, mas ele é a base sobre a qual esperamos construir mais desses recursos quando eles se tornarem uma prioridade e/ou em colaboração com parceiros.