Como eu deveria estruturar as pastas de um projeto de software?

Bom, 26/12, e provavelmente você não está interessado em código.

Mas hoje, fiz uma piada sobre a estrutura de pastas/arquivos, e houve quem não entendeu a referência. Então, decidi soltar uma opinião disfarçada de regra, especialmente para VOCÊ que tem dúvidas sobre como organizar projetos de software.

// Detect dark theme
var iframe = document.getElementById('tweet-1739654510547501135-975');
if (document.body.className.includes('dark-theme')) {
iframe.src = "https://platform.twitter.com/embed/Tweet.html?id=1739654510547501135&theme=dark"
}

✨ TL;DR (nao li e nao lerei em PT-BR)

revire o GitHub de projetos famosos (tem muito no OpenSource), pra entender como devs experientes organizam o código.

Como poderia ser resolvido?

Tudo o que penso resume-se à prática e experimentação, simplesmente porque, a menos que você esteja trabalhando com um framework altamente opinativo, dificilmente essa estrutura reflete no desempenho do seu aplicativo, mas sim na experiência de desenvolvimento ou, para falar bonito, DX.

As pessoas que mais têm essa dúvida são aquelas com pouca experiência prática no mundo real do desenvolvimento de software, e não estou dizendo isso por preconceito; é compreensível. E pensando nisso, por que não atacar a raiz do problema? A experiência.

Sempre que estou em uma conversa com algum desenvolvedor e esse assunto surge, tento esclarecer que na verdade não importa tanto o nome ou a estrutura que EU uso para organizar meus projetos, mas sim o quão compreensível isso é para a minha equipe.

Afinal, usar a mesma estrutura que o