Changeset 60:c074fc456b2a

Timestamp:

02/22/07 15:18:53 (18 months ago)

Author:

Tarek Ziad?? <tarek@…>

Message:

more

Location:

PyCon07

Files:

• create.sh (added)
• exercises.txt (modified) (1 diff)
• material/seven_laws.txt (modified) (2 diffs)
• slides.html (modified) (4 diffs)
• slides.txt (modified) (4 diffs)

PyCon07/exercises.txt

@@ -62 +62 @@
 :::::::::::::
 
-- Grab the picture here: http://upload.wikimedia.org/wikipedia/en/thumb/c/cb/Flyingcircus_2.jpg/300px-Flyingcircus_2.jpg
+- Grab the picture here: http://upload.wikimedia.org/wikipedia/en/thumb/c/cb/Flyingcircus_2.jpg/300px-Flyingcircus_2.jpg or on the provided example.
 
 Exercise 3

PyCon07/material/seven_laws.txt

@@ -82 +82 @@
 
 |important| Think documents like code. Always limit the size of sections, 
-and documents. Modularized documentation is the key.
+examples, etc. Modularized documentation is the key.
 
 Structured documents
@@ -148 +148 @@
 - diagrams
 
+.. |important| image:: important.png
+

PyCon07/slides.html

@@ -430 +430 @@
 <li>example (Tarek, switch on)</li>
 <li>cheatsheet</li>
+<li>see <a class="reference" href="http://docutils.sf.net">http://docutils.sf.net</a></li>
 </ul>
 </div>
@@ -493 +494 @@
 <div class="slide" id="realistic-examples">
 <h1>Realistic examples</h1>
-<p>Drop the <em>foo</em> and <em>bar</em> habits. Examples must be real-life examples, and
-usable as-is.</p>
+<p>Drop the <em>foo</em> and <em>bar</em> habits. Examples must be real-life examples:</p>
 <p>Neh:</p>
 <pre class="literal-block">
@@ -515 +515 @@
 <p><img alt="important" src="media/important.png" /> Spending too much time to find something in the documentation is
 a bad sign.</p>
-<p><img alt="important" src="media/important.png" /> Think documents like code. Always limit the size of sections,
-and documents.</p>
+<p><img alt="important" src="media/important.png" /> Think documents like code. Always limit the size of its sections,
+examples, etc.</p>
 <p><img alt="wink" src="media/wink.png" /> Modularized documentation is the key.</p>
 </div>
@@ -861 +861 @@
 </ul>
 </div>
+<div class="slide" id="pycommunity">
+<h1>PyCommunity</h1>
+<p>A tool that:</p>
+<ul class="simple">
+<li>reads a bundle</li>
+<li>extract its documentation</li>
+<li>generates a website with it</li>
+<li>is not released yet (soon <img alt="wink" src="media/wink.png" />)</li>
+</ul>
+</div>
+<div class="slide" id="id29">
+<h1>PyCommunity</h1>
+<ul class="simple">
+<li>can be hooked in the subversion post-commit hook</li>
+<li>can be configured to inject its generated page in an existing site</li>
+</ul>
+<p><img alt="smile" src="media/smile.png" /> let's try it #exercise 11</p>
+</div>
+<div class="slide" id="conclusions">
+<h1>Conclusions</h1>
+<ul class="simple">
+<li>Using <cite>DDD</cite> is a good way to enhance the QA</li>
+<li>It is enjoyed by most developers</li>
+<li>It increases both writing and programming skills</li>
+</ul>
+</div>
+<div class="slide" id="the-end">
+<h1>The end</h1>
+<ul class="simple">
+<li>Thank you !</li>
+<li>Questions ? Answers ?</li>
+</ul>
+</div>
+<div class="slide" id="references">
+<h1>References</h1>
+<p>Useful books:</p>
+<ul class="simple">
+<li>&quot;Writing with Power&quot; - Peter Elbow</li>
+<li>&quot;Agile Documentation&quot; - Andreas RÃŒping</li>
+</ul>
+<p>Useful websites:</p>
+<ul class="simple">
+<li><a class="reference" href="http://emenciacommerce.com/en">http://emenciacommerce.com/en</a>: Emencia Commerce Suite - My company software</li>
+<li><a class="reference" href="http://tarekziade.wordpress.com">http://tarekziade.wordpress.com</a> : My blog</li>
+</ul>
+</div>
+<div class="slide" id="incoming-events">
+<h1>Incoming Events</h1>
+<p>You all go to Rupy in Poznan, Polan, 14/15 April <img alt="wink" src="media/wink.png" /></p>
+</div>
 </div>
 </body>

PyCon07/slides.txt

@@ -114 +114 @@
 - example (Tarek, switch on)
 - cheatsheet
+- see http://docutils.sf.net
 
 Mastering reSTructuredText
@@ -189 +190 @@
 ==================
 
-Drop the *foo* and *bar* habits. Examples must be real-life examples, and
-usable as-is.
+Drop the *foo* and *bar* habits. Examples must be real-life examples:
 
 Neh::
@@ -215 +215 @@
 a bad sign.
 
-|important| Think documents like code. Always limit the size of sections, 
-and documents. 
+|important| Think documents like code. Always limit the size of its sections, 
+examples, etc.
 
 |wink| Modularized documentation is the key.
@@ -255 +255 @@
 
 Let's do exercise #4 to feel it |glasses|
+
+Topic ideas:
+
+    - cooking recipe
+    - how to play a board or card game
+    - how to fish shrimps 
+ 
 
 Writing a document