[Bologna] Fwd: [lime-users] LiMe broken. (was Re: New mesh network in Oaxaca)

[Ilario Gelmetti]

On 05/31/2015 07:59 PM, Nemesis wrote:
> On 05/31/2015 07:49 PM, ThEgAmEr wrote:
> [...]
>> Thanks, now it's quite clear.
>> I can't find any documentation about LiMe configuration (apart the
>> very basic one that I wrote in Italian [1] where there's also
>> explained that configuration from lime-defaults is always applied,
>> LOL! There is also another document in Italian written by NinuxBO
>> [2]).
>> I think it's time to have such a documentation, so I started a new
>> wiki page about configuration on libre-mesh website [3], you're
>> invited to contribute :D
>> Ciao!
>> Ilario
>>
>> [1] http://wiki.ninux.org/Libre-Mesh#Configurazione
>> [2] https://wiki.bologna.ninux.org/mediawiki/index.php/CompilareDaOpenWrt
>> [3] https://libre-mesh.org/projects/libre-mesh/wiki/Configuration
>>
> 
> Davvero lodevole la vostra iniziativa di documentare il firmware,
> complimenti.

Grazie :D

> Se posso permettermi di dare un consiglio, penso che la documentazione
> in formato ResTructuredText o Markdown conservata in un repository
> github sia la cosa migliore.

Sarebbe figo, però ormai abbiamo iniziato a scriverla sui wiki e non mi
sembra affatto una buona idea spostarla/copiarla.
Eppoi il sito di libre-mesh ha anche la funzione wiki, mi sembra
naturale usarla per metterci la documentazione di libre-mesh...

> Si possono facilmente generare siti attraverso servizi come readthedocs.org.
> 
> Anche per gluon (il progetto firmware di Freifunk) fanno così:
> http://gluon.readthedocs.org/en/latest/index.html
> 
> Gluon ha preso parecchio piede in Germania, e credo che il merito sia
> innanzitutto della documentazione.

Ah, non sapevo dell'esistenza di 'sto Gluon.
Qualcuno l'ha provato?

> Sto cercando di far capire a tutti che la documentazione andrebbe
> scritta durante lo sviluppo, non alla fine (perchè poi non si scrive
> quasi mai).

La prossima volta che vedo Gio lo meno sia da parte mia che da parte tua :P

> Io ad esempio su molte librerie che mantengo non accetto pull request
> per nuove funzionalità amenochè non vengano documentate.

Ah, buona idea.
Ciao!
Ilario

-- 
Ilario Gelmetti
iochesonome a gmail.com
igelmetti a iciq.es
ilario.gelmetti a estudiants.urv.cat

-------------- parte successiva --------------
Un allegato non testuale è stato rimosso....
Nome:        signature.asc
Tipo:        application/pgp-signature
Dimensione:  181 bytes
Descrizione: OpenPGP digital signature
URL:         <http://ml.ninux.org/pipermail/bologna/attachments/20150531/f90877ca/attachment-0001.sig>