You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@tomee.apache.org by bu...@apache.org on 2018/11/20 09:21:39 UTC

svn commit: r1037123 - in /websites/staging/tomee/trunk: cgi-bin/ content/ content/dev/writing-examples.html

Author: buildbot
Date: Tue Nov 20 09:21:39 2018
New Revision: 1037123

Log:
Staging update by buildbot for tomee

Modified:
    websites/staging/tomee/trunk/cgi-bin/   (props changed)
    websites/staging/tomee/trunk/content/   (props changed)
    websites/staging/tomee/trunk/content/dev/writing-examples.html

Propchange: websites/staging/tomee/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Nov 20 09:21:39 2018
@@ -1 +1 @@
-1844535
+1846984

Propchange: websites/staging/tomee/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Nov 20 09:21:39 2018
@@ -1 +1 @@
-1844535
+1846984

Modified: websites/staging/tomee/trunk/content/dev/writing-examples.html
==============================================================================
--- websites/staging/tomee/trunk/content/dev/writing-examples.html (original)
+++ websites/staging/tomee/trunk/content/dev/writing-examples.html Tue Nov 20 09:21:39 2018
@@ -148,7 +148,7 @@
 
 <p>Writing examples that can be used in a presentations is hard.</p>
 
-<p>Some basic guideliness of writing examples:</p>
+<p>Some basic guidelines of writing examples:</p>
 
 <ul>
 <li>focus on one idea per example</li>
@@ -158,13 +158,13 @@
 <li>minimal code to make the point</li>
 </ul></li>
 <li>avoid showing an entire API in one example, if possible</li>
-<li>be concious of the cost of "setting the stage"</li>
+<li>be conscious of the cost of "setting the stage"</li>
 <li>if examples get too big, split it</li>
 </ul>
 
 <h1>Noise vs signal</h1>
 
-<p>It takes time to learn the example scenario (noise).  You need to learn the scenario before you can start to see the imporant parts (signal).</p>
+<p>It takes time to learn the example scenario (noise).  You need to learn the scenario before you can start to see the important parts (signal).</p>
 
 <p>Be very mindful of your noise to signal ratio.</p>
 
@@ -176,7 +176,7 @@
 
 <p>If there are five ways to do the same thing, avoid making five different scenarios.  Copy the example to a new directory, and tweak it to show the variation.</p>
 
-<p>So say you used objects <code>Green</code>, <code>Square</code> and <code>Checkers</code> to show the basic concept and you wish to show the next variation of that same concecpt.  It is tempting to add to the same
+<p>So say you used objects <code>Green</code>, <code>Square</code> and <code>Checkers</code> to show the basic concept and you wish to show the next variation of that same concept.  It is tempting to add to the same
 example objects <code>Yellow</code>, <code>Triangle</code> and <code>PolkaDots</code>.</p>
 
 <p>Avoid that.  Copy <code>Green</code>, <code>Square</code> and <code>Checkers</code> to a new example, change the package name, and update the few lines needed to show the difference.</p>