From 3e838c4fa9e6b8ada549adb7a1481171696b12a7 Mon Sep 17 00:00:00 2001 From: Trey Hunner Date: Wed, 6 Nov 2013 09:52:00 -0800 Subject: [PATCH 1/3] Add file to note workshop response (to learn from) --- experiences.rst | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 experiences.rst diff --git a/experiences.rst b/experiences.rst new file mode 100644 index 0000000..119ceb3 --- /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 1.0`_) + +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. + +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 1.0: https://github.com/pythonsd/test-driven-django-development/releases/tag/v1.0 From f41ee0602d688a759cfcd5a75710559750ae770f Mon Sep 17 00:00:00 2001 From: Micah Denbraver Date: Tue, 3 Jun 2014 18:53:51 -0700 Subject: [PATCH 2/3] Minor changes to experiences document --- experiences.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/experiences.rst b/experiences.rst index 119ceb3..af613c3 100644 --- a/experiences.rst +++ b/experiences.rst @@ -5,7 +5,7 @@ November 2, 2013 San Diego Workshop ----------------------------------- We did a Django TDD workshop on November 2, 2013 in San Diego based on these -tutorials (`version 1.0`_) +tutorials (`version 0.0.1`_) Teaching Method ~~~~~~~~~~~~~~~ @@ -23,8 +23,8 @@ issue to refresh the page and see whether the new copy clarified their issue. Everyone finished the tutorials in about 5 hours. -Feedback -~~~~~~~~ +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 @@ -34,4 +34,4 @@ 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 1.0: https://github.com/pythonsd/test-driven-django-development/releases/tag/v1.0 +.. _version 0.0.1: https://github.com/pythonsd/test-driven-django-development/releases/tag/v0.0.1 From e61e2708453a12c333b7d0b6189b2eda98726d53 Mon Sep 17 00:00:00 2001 From: Micah Denbraver Date: Tue, 3 Jun 2014 18:55:31 -0700 Subject: [PATCH 3/3] Add link to experiences document from the readme --- README.rst | 3 +++ 1 file changed, 3 insertions(+) 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