Changeset 59:8d3e5ca02fce

Timestamp:

02/22/07 14:53:50 (18 months ago)

Author:

Tarek Ziad?? <tarek@…>

Message:

last slides

Location:

PyCon07

Files:

• exercises.txt (modified) (2 diffs)
• outline.txt (modified) (1 diff)
• slides.txt (modified) (1 diff)

PyCon07/exercises.txt

@@ -155 +155 @@
 - Get the package tarball in `material` 
 - Get the text file that explains how pycommunity works, and
-the one that lists its main modules.
+  the one that lists its main modules.
 
 Exercise 6
@@ -301 +301 @@
 :::::::
 
-Take the provided PyCommunity package, and generate the documentation over
-the tests. Change the tutorials, recipes, etc, to see how the generated website
-is changed.
+Take the provided PyCommunity tarball (documented), and generate the 
+documentation over the tests, by calling `pycommunity`. Change the tutorials, 
+recipes, etc, to see how the generated website is changed.
 
 Prerequisites

PyCon07/outline.txt

@@ -117 +117 @@
     - exercice: link the recipe, tutorial and glossary
 
-- website autogeneration with pycommunity - 20 mn  
+Website autogeneration with pycommunity - 20 mn  
+===============================================
 
-  - presentation: pycommunity
-  - exercise: setting up a subversion structure
-  - exercise: setting up a hook for website autogeneration
-  - customize pycommunity for an existing website
+- presentation: pycommunity
+
+- exercises:
+    
+    - exercise 11: pycommunity tests
+    - customize pycommunity for an existing website
 
 - conclusions, Q/A, 10 mn

PyCon07/slides.txt

@@ -603 +603 @@
   - inline comments and doctests
 
+PyCommunity
+===========
+
+A tool that:
+
+- reads a bundle
+
+- extract its documentation
+
+- generates a website with it
+
+- is not released yet (soon |wink|)
+
+PyCommunity
+===========
+
+- can be hooked in the subversion post-commit hook
+
+- can be configured to inject its generated page in an existing site
+
+|smile| let's try it #exercise 11
+
+Conclusions
+===========
+
+- Using `DDD` is a good way to enhance the QA
+
+- It is enjoyed by most developers
+
+- It increases both writing and programming skills 
+
+The end
+=======
+
+- Thank you !
+
+- Questions ? Answers ?
+
+References
+==========
+
+Useful books:
+
+- "Writing with Power" - Peter Elbow
+- "Agile Documentation" - Andreas RÃŒping
+
+Useful websites:
+
+- http://emenciacommerce.com/en: Emencia Commerce Suite - My company software
+- http://tarekziade.wordpress.com : My blog
+
+Incoming Events
+===============
+
+You all go to Rupy in Poznan, Polan, 14/15 April |wink|
 
 .. |wink| image:: media/wink.png