State of the 1.2 documentation

[Yannick Gingras]

Greetings Django-devs,
as stated previously, we organize a translation sprint in Montréal on
2010-02-15. What we have not decided yet is what version of the
documentation we are going to translate. We want our effort to be
included in django-fr.org and they are using the 1.1.1 doc, stating
that 1.2 was too much of a moving target. That's a fair statement but
given that 1.2 beta was just released, it might make sense to review
our strategy. Therefore, I have a few questions that will help us
pick our target.

Do you plan major changes to the documentation before 1.2 final is out?

Are there parts of the documentation that are stable enough to start
working on?

What is the timeframe for 1.2 final?

Thanks for your help and best regards,

--
Yannick Gingras
http://ygingras.net
http://confoo.ca -- track coordinator
http://montrealpython.org -- lead organizer

[Russell Keith-Magee]

On Sun, Feb 7, 2010 at 5:50 AM, Yannick Gingras <ygin...@ygingras.net> wrote:
>
> Greetings Django-devs,
>  as stated previously, we organize a translation sprint in Montréal on
> 2010-02-15.  What we have not decided yet is what version of the
> documentation we are going to translate.  We want our effort to be
> included in django-fr.org and they are using the 1.1.1 doc, stating
> that 1.2 was too much of a moving target.  That's a fair statement but
> given that 1.2 beta was just released, it might make sense to review
> our strategy.  Therefore, I have a few questions that will help us
> pick our target.
>
> Do you plan major changes to the documentation before 1.2 final is out?

There is one major change that I am aware of - a refactoring of the
the i18n documentation. There are also a whole lot of minor changes
that have been submitted as patches.

For a complete list of the changes that are likely to occur, check:

http://code.djangoproject.com/query?status=new&status=assigned&status=reopened&component=Documentation&milestone=1.2&order=priority

> Are there parts of the documentation that are stable enough to start
> working on?

Hard to say, and depends on your measure of "stable". The i18n
refactor is the only *big* change that I'm aware of, but there are a
couple of patches that involve the introduction of fairly hefty (i.e.,
several paragraphs) of new changes.

> What is the timeframe for 1.2 final?

Roughly, the start of March. RC1 is scheduled for March 2, final for a
week later. These dates are slightly flexible - if we still have
showstopper bugs on March 2, we won't cut a release - but that's the
timeframe we're aiming at.

Yours,
Russ Magee %-)

[Yannick Gingras]

On February 6, 2010, Russell Keith-Magee wrote:
> > What is the timeframe for 1.2 final?
>
> Roughly, the start of March. RC1 is scheduled for March 2, final for a
> week later. These dates are slightly flexible - if we still have
> showstopper bugs on March 2, we won't cut a release - but that's the
> timeframe we're aiming at.

Thanks a lot, Russ. This really helps us pick a useful target.