Apesar do formato atual permitir uma personalização maior, a sugestão é que seja usado algum framework com foco em documentação, para que alunos que possuam pouco conhecimento de programação também possam contribuir.
O Starlight foi escolhido, pois o framework é focado em documentação.
Apesar disso trazer alguns problemas, também ajuda a manter o foco do projeto em torno do manual, evitando que ele cresça além disso.
Essa migração visa diminuir o bloat do FCT App.
Apesar do formato atual permitir uma personalização maior, a sugestão é que seja usado algum framework com foco em documentação, para que alunos que possuam pouco conhecimento de programação também possam contribuir.
Docusaurus - ReactNextra - Next.js (React)Material for MkDocs - PythonPensando na facilidade de manutenção, excluímos frameworks como Gatsby e Hugo.
Também devem ser separadas a página do calouro e a lista de entidades estudantis.
A hospedagem será realizada no GitHub Pages, no repositório cacic-fct/manual-do-calouro.
O Starlight foi escolhido, pois o framework é focado em documentação. Apesar disso trazer alguns problemas, também ajuda a manter o foco do projeto em torno do manual, evitando que ele cresça além disso.