On Thu, Jan 17, 2013 at 1:17 PM, Daniel Greenfeld <pyda...@gmail.com> wrote:

>
>
> On Wednesday, January 16, 2013 4:43:14 PM UTC-8, Russell Keith-Magee wrote:
>
>> Hi Daniele,
>>
>> On Thu, Jan 17, 2013 at 7:07 AM, Daniele Procida 
>> <evi...@googlemail.com>wrote:
>>
>>>
>>>  2) This is what version control is for. I'd much rather see someone do
>> the tutorial and use version control on their own repository, rather than
>> just pull down the latest version of a repo that contains all the code they
>> need.
>>
>> Following point 2, it might be worth suggesting that people use version
>> control during the tutorial. I'm not suggesting we turn the Django tutorial
>> into a parallel tutorial on git, but seeding the idea in people's heads has
>> the benefit of reinforcing best practice (you do version control everything
>> you do, right?), and makes it easier to work around the rollback problems
>> you describe; if they don't know what version control is, they might be
>> encouraged to go investigate, and as a result, another code-fairy gets
>> their wings :-)
>>
>
> There are already third-party versions of the Django tutorial that also
> instruct on source control and TDD. These are great, and wonderful, but I
> feel they overwhelm beginner Django developers with too much.
>

To be clear -- I'm not suggesting we try and make the Django tutorial a
parallel tutorial on source control. I'm just suggesting that we drop a
gentle hint at the start of the tutorial, to the effect of:

"If you know how to use a source control system (like Git), you might want
to set up your tutorial directory as a repository.

If you don't know how to use a source control system, don't worry. You
don't need to know anything about source control to complete this tutorial.
However, source control systems are incredibly useful tools that are used
widely in software development, and you'd be well advised to learn how to
use them."

and then, after completing relevant blocks of work:

"If you're using source control on this project, now would be a good time
to commit what you've done."

The aim is to encourage best practice, or at least make users *aware* of
best practice, but leave the details up to them.

Yours,
Russ Magee %-)

-- 
You received this message because you are subscribed to the Google Groups 
"Django developers" group.
To post to this group, send email to django-developers@googlegroups.com.
To unsubscribe from this group, send email to 
django-developers+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/django-developers?hl=en.

Reply via email to