📝 revise .github, readme, comments

.github/contributing.md

@@ -4,7 +4,16 @@
 
 ## Reduced test cases required
 
-All bug reports and problem issues require a [**reduced test case**](https://css-tricks.com/reduced-test-cases/). Create one by [forking this CodePen](https://codepen.io/desandro/pen/xNLWwG).
+All bug reports and problem issues require a [**reduced test case**](https://css-tricks.com/reduced-test-cases/). Create one by forking this any one of the [Zdog demos on CodePen](https://codepen.io/desandro/pens/tags/?grid_type=list&selected_tag=zdog-v1-docs&sort_col=created_at&sort_order=asc).
+
+**CodePen**
+
++ [Hello world canvas](https://codepen.io/desandro/pen/YbrLaO)
++ [Hello world SVG](https://codepen.io/desandro/pen/Bewxme)
++ [resize fullscreen](https://codepen.io/desandro/pen/dEJxaV)
++ [Stutter](https://codepen.io/desandro/pen/xNPaoP)
+
+**Test cases**
 
 + A reduced test case clearly demonstrates the bug or issue.
 + It contains the bare minimum HTML, CSS, and JavaScript required to demonstrate the bug.

.github/issue_template.md

@@ -1,3 +1,3 @@
-<!-- Thanks for submitting an issue! If you have a bug or problem issue, please include a **reduced test case**. Create one in CodePen or other demo site. See guidelines link above. -->
+<!-- Thanks for submitting an issue! If you have a bug or problem issue, please include a **reduced test case**. Create one in CodePen or other demo site. See contributing guidelines. -->
 
-**Test case:** https://codepen.io/desandro/pen/xNLWwG
+**Test case:** https://codepen.io/desandro/pen/YbrLaO

README.md

@@ -32,7 +32,7 @@ Create 3D models with Zdog by adding shapes. See [Getting started](https://zzz.d
 ``` js
 let isSpinning = true;
 
-const illo = new Zdog.Illustration({
+let illo = new Zdog.Illustration({
   element: '.zdog-canvas',
   zoom: 4,
   dragRotate: true,
@@ -86,7 +86,7 @@ Zdog v1 is a beta-release, of sorts. This is my first time creating a 3D engine,
 
 ### Other Zdog repos
 
-+ [zdog-demos](https://github.com/metafizzy/zdog-demos) - More, bigger, wilder Zdog demos
++ [zdog-demos](https://github.com/metafizzy/zdog-demos) - Bigger, wilder Zdog demos
 + [zdog-docs](https://github.com/metafizzy/zdog-docs) - Documentation site source code for [zzz.dog](https://zzz.dog)
 
 ---

demos/hemisphere-cone-ball/hemisphere-cone-ball.js

@@ -23,7 +23,7 @@ var orange = '#E62';
 var garnet = '#C25';
 var eggplant = '#636';
 
-// -- illustration shapes --- //
+// ----- model ----- //
 
 var hemi = new Zdog.Hemisphere({
   addTo: illo,
@@ -68,7 +68,7 @@ var colorWheel = [ eggplant, garnet, orange, gold, yellow, ];
   }
 });
 
-// -- animate --- //
+// ----- animate ----- //
 
 var keyframes = [
   { x: TAU * 0,   y: TAU * 0 },
@@ -86,10 +86,6 @@ function animate() {
   requestAnimationFrame( animate );
 }
 
-animate();
-
-// -- update -- //
-
 function spin() {
   if ( !isSpinning ) {
     return;
@@ -104,3 +100,5 @@ function spin() {
   illo.rotate.y = Zdog.lerp( keyA.y, keyB.y, tween ) ;
   ticker++;
 }
+
+animate();

demos/kid-kit/kid-kit.js

@@ -1,4 +1,4 @@
-// --- variables --- //
+// ----- setup ----- //
 
 var offWhite = '#FED';
 var gold = '#EA0';
@@ -11,7 +11,7 @@ var illo = new Zdog.Illustration({
   dragRotate: true,
 });
 
-// --- model --- //
+// ----- model ----- //
 
 // body center
 new Zdog.Shape({
@@ -294,7 +294,7 @@ cloakSide.copyGraph({
 });
 
 
-// -- animate --- //
+// ----- animate ----- //
 
 function animate() {
   illo.updateRenderGraph();

demos/shade-and-shades/shade-and-shades.js

@@ -28,7 +28,7 @@ var illo = new Zdog.Illustration({
   },
 });
 
-// -- illustration shapes --- //
+// ----- model ----- //
 
 // cap top
 [ 0, 1, 2, 3, 4 ].forEach( function( i ) {

demos/solids/solids.js

@@ -385,7 +385,7 @@ solids.push( cube );
 
 })();
 
-// -- animate --- //
+// ----- animate ----- //
 
 var keyframes = [
   { x:   0, y:   0 },