Instructions inside the test classes, because people don't read the R…

…EADME

src/test/java/tetris/FallingBlocksTest.java

@@ -14,6 +14,10 @@
 @RunWith(NestedJUnit.class)
 public class FallingBlocksTest extends Assert {
 
+    // Step 1: Starting small
+    // - See the README for motivation
+    // - Next step: RotatingPiecesOfBlocksTest
+
     private final Board board = new Board(3, 3);
 
 

src/test/java/tetris/FallingPiecesTest.java

@@ -14,6 +14,11 @@
 @RunWith(NestedJUnit.class)
 public class FallingPiecesTest extends Assert {
 
+    // Step 4: Safe steps
+    // - Remove the @Ignore annotation from this class
+    // - See the README for how to proceed with this refactoring in safe steps
+    // - Next step: MovingAFallingPieceTest
+
     private final Board board = new Board(6, 8);
 
 

src/test/java/tetris/MovingAFallingPieceTest.java

@@ -12,6 +12,11 @@
 @RunWith(NestedJUnit.class)
 public class MovingAFallingPieceTest extends Assert {
 
+    // Step 5: It's your turn now
+    // - Remove the @Ignore annotation from this class
+    // - The test names have been provided, you just need to fill in the test body
+    // - Next step: RotatingAFallingPieceTest
+
     // TODO: a falling piece can be moved left
     // TODO: a falling piece can be moved right
     // TODO: a falling piece can be moved down

src/test/java/tetris/RotatingAFallingPieceTest.java

@@ -12,6 +12,11 @@
 @RunWith(NestedJUnit.class)
 public class RotatingAFallingPieceTest extends Assert {
 
+    // Step 6: Training wheels off
+    // - Remove the @Ignore annotation from this class
+    // - You're now responsible for covering all corner cases
+    // - Next step: see the README for details
+
     // TODO: a falling piece can be rotated clockwise
     // TODO: a falling piece can be rotated counter-clockwise
     // TODO: it can not be rotated when there is no room to rotate (left wall, right wall, other pieces...)

src/test/java/tetris/RotatingPiecesOfBlocksTest.java

@@ -14,6 +14,11 @@
 @RunWith(NestedJUnit.class)
 public class RotatingPiecesOfBlocksTest extends Assert {
 
+    // Step 2: Stepping stone for rotation algorithms
+    // - Remove the @Ignore annotation from this class
+    // - See README for motivation
+    // - Next step: RotatingTetrominoesTest
+
     private Piece piece;
 
 

src/test/java/tetris/RotatingTetrominoesTest.java

@@ -14,6 +14,11 @@
 @RunWith(NestedJUnit.class)
 public class RotatingTetrominoesTest extends Assert {
 
+    // Step 3: The actual rotation algorithms
+    // - Remove the @Ignore annotation from this class
+    // - See README for how "Tetromino" is different from "Piece"
+    // - Next step: FallingPiecesTest
+
     private Tetromino shape;