Re: manuale tecnico aggiornabile

#77693
robitex
Amministratore del forum
    Up
    0
    Down
    ::

    renareto” post=76863No, ma intendi, non è che io voglia usare il DB! anzi! E’ che pensavo a questo come repo “ufficiale”. Invece, tu dici:
    – fai tutto con dei file di testo
    – li carichi su un GIT per il versioning
    – i singoli programmatori aggiornano la parte che gli serve
    – una persona (io) si incarica di compilare il tutto, quando serve il manuale

    Una cosa del genere?

    Renato

    Potrebbe essera la soluzione. Tieni conto che io uso questo metodo per scrivere le guide tematiche del GuIT.
    Uso github per i repo pubblici o bitbucket se deve rimanere segreto! Nulla vieta di far girare git sulla rete LAN.
    Nel tuo caso, ognuno avrebbe il proprio repo personale con GIT ed interverebbe sulle parti di proprio interesse, poi un coordinatore riceve i commit del brach principale, gestisce i casi di conflitto e cura la compilazione.
    Secondo me, alla fine ti è necessario anche un file di classe apposito per il tuo manuale, che si occupi di definire layout, loghi ambienti particolari per comporre reference di comandi per esempio, ecc

    Rimane da esplorare la questione del literate programming (scrivere la doc direttaemnte nei sorgenti).
    Parlatene.
    R.

    Go to top