Guia completo de instalação

[ppKrauss]

estou com git atualizado em "mkdocs, version 1.2.2"... Mas bash gera_docs.bash dá erro... usei sudo, o que não é bom...
Feito isso, gerou

ls /tmp/mkdocs/
     docs.addressforall.org  docs.digital-guard.org  docs.itgs.org.br  docs.osm.codes
ls /tmp/mkdocs/docs.addressforall.org/
   a4a_index.html  documentation_generator  suporte

Parece ok...

A versão do mkdocs utilizada foi a mesma, 1.2.2. No script gera_docs.bash não tem nada que precise de privilégios de superusuário. Basicamente, link simbólicos são criados na /tmp apontando para as localizações dos diversos gits, e o mkdocs é chamado para construir as documentações.

Os gits em /opt/gits/_[código_organização] necessitam de sudo para serem manipulados. Então a necessidade de sudo advém das atuais permissões dessas pastas.

Se as restrições em /opt/gits/_[código_organização] não puderem ser minimizadas, para que não seja necessário sudo para gerar links simbólicos e acessar os arquivos, penso que a alternativa seria espelhar o contéudo de /opt/gits em outro lugar alterando as permissões para que não seja necessário privilégios.

A opção por links simbólicos é para evitar cópias desnecessárias no servidor. E a opção por usar /tmp é para evitar a escrita dentro das pastas onde estão os gits.