Re: contribuire alla documentazione italiana di php

Spero di aver fatto giusto: https://github.com/php/doc-it/pull/1

grazie per l'aiuto!
ciao
--
Massimiliano Arione


Il giorno gio 28 gen 2021 alle ore 12:43 Davide Pastore <[email protected]>
ha scritto:

> Ciao Massimiliano,
>
> l'errore che si ripete da tempo sulla build non è reale, ma è legato ad un
> problema della migrazione che non tiene conto dell'ultima versione
> attualmente presente su Git, dato che la traduzione italiana è attualmente
> flaggata come "not maintained" (o qualcosa di molto simile). Ho già chiesto
> per due volte di risolvere il problema, in modo da rendere il processo
> della build uguale a prima, ma finora non ho avuto chiarimenti in merito e
> per questo non sono particolarmente felice.
>
> Lo script che genera le differenze tra la versione inglese e quella di
> un'altra lingua è revcheck.php ma tuttora (nel branch master di doc-base
> <https://github.com/php/doc-base>) resta non migrato per Git e non
> funziona come si deve. Un utente aveva cominciato a lavorarci ma a quanto
> pare non ha continuato. Nel frattempo possiamo dare un'occhiata al suo
> lavoro tramite questo link <http://doc.php.gpb.moe/tools/revcheck/it/> in
> cui si possono vedere i vari file da aggiornare, quelli da aggiungere e
> quelli da rimuovere. Cliccando su diff ti si aprirà un link di GitHub che
> contiene tutti i file cambiati dalla versione del file non aggiornato
> (italiano) a quella dell'ultima inglese. In questa lista dovrai andare a
> trovare il file che stai provando ad aggiornare ed utilizzare il suo diff
> per modificare in modo corrispondente la versione italiana. Una volta
> concluso questo processo, ricordati di aggiornare il valore *EN-Revision*
> presente nel commento in testa al file, utilizzando quello corrispondente
> della versione inglese. A questo punto puoi procedere e creare una pull
> request sulla repository <https://github.com/php/doc-it> per proporre la
> tua modifica.
>
> Se dovessi aver bisogno di qualsiasi altra informazione, non esitare a
> chiedere.
>
> Buona giornata,
> Davide
>
> Il giorno gio 28 gen 2021 alle ore 10:34 Massimiliano Arione <
> [email protected]> ha scritto:
>
>> Ciao Davide,
>> torno alla carica dopo un po' di tempo.
>> Sto ancora cercando di capire il flusso di build della documentazione,
>> almeno per provare a risolvere quell'errore che si ripete da tempo.
>> Ho installato sulla mia macchina php/phd ma non credo di aver ben capito
>> come funziona, se provo a eseguire il file render.php dandogli in pasto un
>> xml ottengo un sacco di notice e qualche warning, più una manciata di file
>> in una cartella output (che tra l'altro non è nemmeno in .gitignore
>> Hai suggerimenti?
>> Pensi che possiamo prenderci qualche minuto in una qualsiasi chat per
>> rivedere la situazione insieme?
>>
>> grazie
>> ciao
>> --
>> Massimiliano Arione
>>
>>
>>
>> Il giorno gio 31 dic 2020 alle ore 10:22 Davide Pastore <
>> [email protected]> ha scritto:
>>
>>> Ciao Massimiliano,
>>>
>>> innanzitutto ti ringrazio per l'interessamento nel voler tradurre la
>>> documentazione di PHP. Tutte le comunicazioni inerenti la traduzione
>>> italiana avvengono nella mailing list [email protected] (che ho
>>> aggiunto come destinatario di questa e-mail e alla quale puoi iscriverti
>>> mandando una mail qui <[email protected]>). Puoi trovare
>>> un tutorial non aggiornato qui <https://github.com/php/doc-base>, dato
>>> che effettivamente è stata fatta una migrazione da SVN verso GIT che ci dà
>>> la possibilità di accettare più facilmente le patch dalla comunità ma allo
>>> stesso tempo ha rotto alcuni script utilizzati per la costruzione delle
>>> diff dei file (in modo da tradurre solo il delta e non l'intero file da
>>> zero ogni volta che la versione inglese viene aggiornata). Oltre a questo,
>>> nel tutorial troverai riferimenti all'Online Documentation Editor (
>>> https://edit.php.net/) che è anch'esso non più funzionante dopo questa
>>> migrazione. Aspettavo questa migrazione da diversi anni e sono molto felice
>>> di questo salto, anche se bisogna un po' sistemare gli strumenti utilizzati
>>> (revcheck tra tutti), come ti dicevo in precedenza.
>>>
>>> *Chi siamo?*
>>> Mi dispiace dirlo, ma da più di un paio d'anni sono stato l'unico che ha
>>> contribuito. Le mie modifiche fanno in modo che la documentazione continui
>>> a galleggiare, evitando che la build rimanga rotta troppo a lungo.
>>>
>>> *Nel frattempo, come puoi procedere?*
>>> Segui il tutorial e dopo aver fatto il checkout della documentazione
>>> (sia inglese che italiana), datti una lettura a qualche file xml per vedere
>>> la struttura degli stessi. Appena avremo il revcheck sistemato, potrai
>>> procedere con delle nuove modifiche o aggiunte.
>>>
>>> Se dovessi aver bisogno di una mano, chiedi senza alcun problema.
>>>
>>> Buona giornata,
>>> Davide Pastore
>>>
>>>
>>> Il giorno mer 30 dic 2020 alle ore 15:55 Massimiliano Arione <
>>> [email protected]> ha scritto:
>>>
>>>> Ciao Davide,
>>>> ho letto or ora del porting della documentazione di php su github e dal
>>>> repo principale ho trovato subito quello della traduzione italiana, di cui
>>>> mi pare tu sia il responsabile.
>>>> Volevo capire quale potrebbe essere il modo migliore per dare il mio
>>>> contributo, perché purtroppo il repo stesso manca di README (o di altre
>>>> istruzioni)
>>>>
>>>> grazie in anticipo
>>>> saluti
>>>> --
>>>> Massimiliano Arione
>>>>
>>>>