diff --git a/README.rst b/README.rst index 8eddfe0..c7b9023 100644 --- a/README.rst +++ b/README.rst @@ -10,9 +10,12 @@ but rather intended to provide additional insight and knowledge. It is best if users go through the tutorials and understand the absolute basics of Django before the workshop. +We have included some `experiences`_ of past workshops using these materials. + .. _Django: https://djangoproject.com .. _San Diego Python: http://pythonsd.org .. _Django tutorials: https://docs.djangoproject.com/en/1.5/intro/tutorial01/ +.. _experiences: experiences.rst Tutorials diff --git a/experiences.rst b/experiences.rst new file mode 100644 index 0000000..af613c3 --- /dev/null +++ b/experiences.rst @@ -0,0 +1,37 @@ +Experiences with the tutorials +============================== + +November 2, 2013 San Diego Workshop +----------------------------------- + +We did a Django TDD workshop on November 2, 2013 in San Diego based on these +tutorials (`version 0.0.1`_) + +Teaching Method +~~~~~~~~~~~~~~~ + +We split into 5 groups at large tables, ensuring a reasonable mix of users +that were new and experienced at programming/webdev/Django/TDD. Each user +walked through the tutorials at their own pace. Four of us floated around +the room answering questions and noting everyone's place in the tutorials. + +Most hang-ups were experienced by multiple tables independently. When an issue +was found with the tutorials, one of us would start drafting a pull request +(to improve clarity or fix a bug). We usually merged the pull requests after +at least one other volunteer reviewed it We asked anyone else who had the +issue to refresh the page and see whether the new copy clarified their issue. + +Everyone finished the tutorials in about 5 hours. + +Participant Feedback +~~~~~~~~~~~~~~~~~~~~ + +The feedback was very positive. The primary negative feedback I remember was +that some occasionally felt like they were just copy-pasting. I think this +could be resolved by adding some more explanation for some sections and +encouraging users not to copy-paste (as suggested by Learn Python the Hard +Way). One user also noted that he often forgot to go look at the site after +adding a feature. We should probably ask users to go inspect the relevant +part of the site whenever their tests pass. + +.. _version 0.0.1: https://github.com/pythonsd/test-driven-django-development/releases/tag/v0.0.1