[Docs] Documentazione ReST-based

[Manlio Perillo]

Daniele Varrazzo ha scritto:
> Ciao,
> 
> dove si trovano info su questa fantomatica documentazione ReST-based di cui
> sto sentendo parlare in questi giorni?
> 

http://pydoc.gbrandl.de:3000/

C'è anche una versione aggiornata del Documenting Python.

I sorgenti invece si trovano nel repository ufficiale di python.

Come si vede, le novità sono il supporto per "Suggest changes" e "Report 
bug", oltre alla funzionalità di ricerca (il tutto ancora da implementare).

Infine c'è il supporto per "Visualizza sorgenti".

sphinx è ancora immaturo.
Alan Franzoni soggerisce di usarlo anche per gestire le traduzioni, ma 
richiederebbe comunque uno sforzo non indifferente per ampliare il codice.

Nota: spinx ha un server web integrato, tramite wsgiref (ossia, al 
momento credo che quel sito che ho indicato sia servito dal server 
giocattolo della libreria standard)...



> Per me prima ci si sbarazza di quella basata su LaTeX e meglio è, per cui
> non vedo l'ora che *a python.org* facciano il pasasaggio. 

Si, è senz'altro una buona cosa.

> Per quanto
> riguarda noi, penso che sia meglio non cambiare formato facendo una
> traduzione, quindi direi ReST per i PEP e LaTeX per i docs. O sbaglio?
> 

Dici bene.
Anche le FAQ sono in reST.

Conviene cambiare formato per la documentazione standard per Python 2.6, 
magari con qualcuno di noi che collabori allo sviluppo di sphinx e 
aggiunga funzionalità per dare supporto anche alle traduzioni.



Saluti  Manlio Perillo