Italian Documentation
Picio
is there anyone that knows about any Italian translated Django
documentation?
I'm translating the basic tutorial (1,2,3,4) for myself, is it helpful
for anybody?
Let me know.
Thanks a lot
Picio
lbolo...@gmail.com
I'm afraid it will soon be obsolete and require a lot of work to keep
it in sync with the official docs. But if u want, once u're finished i
can review it.
Sorry but i don't have time to help u out.
Lorenzo
Daniele Spino
A trivial question: Is it better to wait 1.0 for me to learn django?
It will be completely different from 0.95?
Can I talk you in italian?
Daniele
lbolo...@gmail.com
Sure, you can contact me privately if u want to talk about it in
italian. I don't think there will be many breaking changes in 1.0 but i
don't follow the changesets so i really can't tell.
Lorenzo
paolo
This page on the wiki should answer all your questions:
http://code.djangoproject.com/wiki/TranslateDocumentation
Differently, ask!
I can assure that translate live documentation (docs in the trunk I
mean) and keep it up to date is a real pain, I did so but it
definitively it is not the best approach if you haven't a lot of time
at your disposal. You could rather consider to stick on official
releases.
As documentation for a particular Django release is frozen once the
version has been released officially, unless some security update
forces a change to some document, I suggest you to keep translated the
last stable release (0.95, at the moment) and go for it. (more details
here: http://www.djangoproject.com/documentation/documentation/ )
I think that update translations from a release to the next release
should be reasonably smooth and easy.
Paolo
paolo
In my opinion, NO. Why wait for 1.0? If you are learning Django you
have two choices: use an official release or stay with the trunk.
I'm using the trunk since I'm using Django, and I never had problems.
However I must say that each time I do an svn up I always feel the fear
that something breaks. But it is just a personal problem, I repeat that
I never had any kind of unpleasant situation. If you choose for the
trunk be sure to read
http://code.djangoproject.com/wiki/BackwardsIncompatibleChanges .
Anyway, now I would choose stable releases. It is supposed, for the
most of the times, that someone that is learning Django isn't
interested in the bleeding edges features, and maybe it's better to
have them in the next official release, in all their reliability.
Do you want a diff from the current Django release and 1.0? Look here:
http://www.djangoproject.com/documentation/api_stability/
Paolo
P.S.
Please, next time could you please create a dedicated thread when ask
different questions? Thanks.
Daniele Spino
About the suggestion on 1.0 I've already started learning 0.95. Thanks.
About the documentation:
1. I considered from the beginning only the official release 0.95 tutorial.
2. In the page you mentioned I saw that tutorial part 1 italian is
already finished by you
so mine would be a "surplus". From now on I will check the page
before any translation start.
3. The reason why I decided to translate the official tutorial is just
to help myself into learning Django. I don't pretend to be so good in
translation so a supervision would be necessary. (And also I don't
know well the Rest formatting). But I definitely offer my help in
translate docs.
4 I wold go ahead and do tutorial part 2,3,4 are you aready there?
Picio
P.S: I'm from Rome and you?
paolo
> already finished by you
> so mine would be a "surplus". From now on I will check the page
> before any translation start.
Hmm rather than a "surplus" it is just another translation of the same
document (and that was one of that things we want avoid, in respect of
DRY!).
My translations are kept on the Django wiki, so if you think you can
improve their quality make changes and add yourself as a "contributor"
at the top of the document, if you want. Obviously the two translations
could coexist also :-)
> 3. The reason why I decided to translate the official tutorial is just
> to help myself into learning Django. I don't pretend to be so good in
> translation so a supervision would be necessary. (And also I don't
> know well the Rest formatting). But I definitely offer my help in
> translate docs.
This is my idea: if you need a "review", once you finish a translation,
make it public (for example via Django I18N mailinglist - let's join it
if you are not) and some of us italian users probably will give you a
feedback.
About reStructuredText I can suggest to download docutils, install it
and see by yourself if your reST formatting is ok.
A final note: if you are interested in Italian translations of docutils
documentation look here: http://docit.bice.dyndns.org/ReST/
> 4 I wold go ahead and do tutorial part 2,3,4 are you aready there?
Go go!
> P.S: I'm from Rome and you?
>From Mantua.
P.S.
Consider to add you name/email to
http://code.djangoproject.com/wiki/Localization
Picio
Many many thanks.
Daniele