Restructuring the flow

[libremente]

Attualmente il flow non è ben pensato e non è assolutamente ottimizzato. Per avere un flow ottimale a mio avviso è necessario pensare alla seguente struttura:

• [ ] Usare sempre il runestone upstream. Questo implica rimuovere il fork attualmente utilizzato in quanto è difficile da mantenere e non ci porta alcun beneficio
• [ ] Creare un repo di templating. Questo repo conterrebbe il template (derivato dallo std bootstrap sphinx) + le configurazioni (file conf.py e pavement.py).
• [x] Repo per i sorgenti (già presente, vedi il presente repo).

In questo modo è anche possibile automatizzare tutto il flow partendo da questo repo. Automatizzare implica il seguente flow:

1. PR mergiata su questo repo
2. Parte circleci che builda from scratch un runestone vanilla applicando le conf del repo 2. e il template.
3. Dopo la build, pusho i risultati direttamente sul server di prod e ho quindi il libro sempre aggiornato.

Al momento questo mi sembra il flusso migliore. Che ne dici @marioscovazzi? 📣

[libremente]

Dopo un'analisi del runestone init ho notato che in realtà fa esclusivamente delle operazioni banali di copia e fill di template. Quindi a questo punto direi che il flusso completo potrebbe essere il seguente:

1. Installazione del runestone ufficiale (non forkato)
2. Applicazione del nostro template + conf (clone del nuovo repo chiamato -template)
3. Importazione del progetto con i sorgenti (clone locale del repo chiamato -chapters)
4. Build
5. Se fatto in CI/CD, rsync su endpoint remoto.

Mi sembra il modo più pulito e corretto di procedere.

[libremente]

Now it works as expected. I'm closing this issue @marioscovazzi and I will open issues for each repo in order to write documentation.