[ninux-dev] Fwd: [Nodeshot] Documentation (work in progress)

[Giuseppe De Marco]

Complimenti fede, ottimo lavoro ho appena installato tutto :)

giusto questa eccezione in /admin:
"You're using the Django "sites framework" without having set the SITE_ID
setting. Create a site in your database and set the SITE_ID setting to fix
this error."

che basta aggiungere in readthedocs di decommentare #SITE_ID in settings.py.

per il git ho clonato direttamente refactoring.

Poi, non voglio scocciarti ma preferisco la UI classica dell'admin perchè
il verde riposa la vista, questo blue tungsteno mi uccide :)

se poi tu volessi passare a OpenLayers... :)



Il giorno 27 novembre 2013 21:52, nemesis <nemesis at ninux.org> ha scritto:

> Volevo mostrarvi lo strumento che sto sando per la documentazione di
> nodeshot:
>
> http://nodeshot.readthedocs.org/en/latest/
>
> Dovremmo cercare di documentare il più possibile quello che facciamo.
>
> Ho deciso che comincerò a documentare quello che faccio MENTRE scrivo il
> codice, così come ho fatto con gli unit test.
>
> Gli unit test mi stanno aiutando moltissimo quando riscrivo parti
> dell'applicazione cercando di migliorare il codice, perchè quando cambio le
> cose sgamo subito i bug e così sono sicuro che anche dopo che cambio
> parecchia roba le funzionalità critiche continuano a funzionare.
>
> Scrivere la documentazione mentre scrivo il codice mi aiuterà a non
> dimenticare perchè ho fatto certe scelte piuttosto che altre. Mi è già
> successo con alcune parti che ho scritto diversi mesi fa.. già mi sono
> scordato qualcosa e ci metto un pò a ricordare.
>
> Ovviamente questo avrà conseguenze positive anche per gli altri, in primis
> una buona documentazione permetterà ad altri di partecipare.
>
> Quindi la mia è un esortazione ed un auto critica a migliorare
> documentazione e testing automatizzato di quello che facciamo.
>
> Se non lo facciamo stiamo semplicemente cazzeggiando, perchè quello che
> facciamo non potrà essere utilizzato da altri.
>
> Federico
>
>
> -------- Original Message --------
> Subject: [Nodeshot] Documentation (work in progress)
> Date: Wed, 27 Nov 2013 18:12:08 +0100
> From: nemesis <nemesis at ninux.org>
> To: <nodeshot at ml.ninux.org>
> Reply-To: Nodeshot <nodeshot at ml.ninux.org>
>
> Grab it here:
>
> http://nodeshot.readthedocs.org/en/latest/
>
> If you wanna help you could try the install procedure and see if there's
> any issue.. I've been working often on it latelly.
>
> Docs are made with sphinx, source files are contained here:
> https://github.com/nemesisdesign/nodeshot/tree/refactoring/docs
>
> Nemesis
> _______________________________________________
> Nodeshot mailing list
> Nodeshot at ml.ninux.org
> http://ml.ninux.org/mailman/listinfo/nodeshot
>
> _______________________________________________
> ninux-dev mailing list
> ninux-dev at ml.ninux.org
> http://ml.ninux.org/mailman/listinfo/ninux-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://ml.ninux.org/pipermail/ninux-dev/attachments/20131127/b7f7e5b8/attachment-0001.html>