Updating PHPDoc.

Author: cyrilverloop

src/Puzzle.php

@@ -4,9 +4,16 @@
 
 namespace CyrilVerloop\Codingame;
 
+/**
+ * A base class for puzzle.
+ */
 abstract class Puzzle
 {
     // Methods :
 
+    /**
+     * Execute the code of the puzzle.
+     * @param resource $stdin the resource to get the datas from.
+     */
     abstract public function execute($stdin): void;
 }

src/Training/Easy/ASCIIArt/ASCIIArt.php

@@ -6,6 +6,9 @@
 
 use CyrilVerloop\Codingame\Puzzle;
 
+/**
+ * The "ASCII Art" puzzle.
+ */
 class ASCIIArt extends Puzzle
 {
     // Methods :

src/Training/Easy/Defibrillators/Defibrillators.php

@@ -6,6 +6,9 @@
 
 use CyrilVerloop\Codingame\Puzzle;
 
+/**
+ * The "Defibrillators" puzzle.
+ */
 class Defibrillators extends Puzzle
 {
     // Methods :

src/Training/Easy/HorseRacingDuals/HorseRacingDuals.php

@@ -6,6 +6,9 @@
 
 use CyrilVerloop\Codingame\Puzzle;
 
+/**
+ * The "Horse-racing Duals" puzzle.
+ */
 class HorseRacingDuals extends Puzzle
 {
     // Methods :

src/Training/Easy/MIMEType/MIMEType.php

@@ -6,6 +6,9 @@
 
 use CyrilVerloop\Codingame\Puzzle;
 
+/**
+ * The "MIME Type" puzzle.
+ */
 class MIMEType extends Puzzle
 {
     // Methods :

src/Training/Easy/Temperatures/Temperatures.php

@@ -6,6 +6,9 @@
 
 use CyrilVerloop\Codingame\Puzzle;
 
+/**
+ * The "Temperatures" puzzle.
+ */
 class Temperatures extends Puzzle
 {
     // Methods :

src/Training/Easy/Unary/Unary.php

@@ -6,6 +6,9 @@
 
 use CyrilVerloop\Codingame\Puzzle;
 
+/**
+ * The "Unary" puzzle.
+ */
 class Unary extends Puzzle
 {
     // Methods :

tests/PuzzleTest.php

@@ -7,22 +7,22 @@
 use PHPUnit\Framework\TestCase;
 
 /**
- * @coversDefaultClass \CyrilVerloop\Codingame\Training\Easy\HorseRacingDuals\HorseRacingDuals
+ * Base class for testing puzzles.
  */
 abstract class PuzzleTest extends TestCase
 {
     // Properties :
 
-    /**
-     * @var \CyrilVerloop\Codingame\Puzzle the puzzle.
-     */
+    /** @var \CyrilVerloop\Codingame\Puzzle the puzzle. */
     protected $puzzle;
 
 
     // Methods :
 
     /**
-     * Expects execute to output answer.
+     * Expects `execute()` to output answer.
+     * @param string $filename the file name.
+     * @param string $expectedAnswer the expected answer.
      */
     protected function expectExecuteOutputAnswer(string $filename, string $expectedAnswer): void
     {

tests/Training/Easy/ASCIIArt/ASCIIArtTest.php

@@ -8,7 +8,9 @@
 use CyrilVerloop\Codingame\Training\Easy\ASCIIArt\ASCIIArt;
 
 /**
- * @coversDefaultClass \CyrilVerloop\Codingame\Training\Easy\ASCIIArt\ASCIIArt
+ * Tests for the "ASCII Art" puzzle.
+ *
+ * @covers \CyrilVerloop\Codingame\Training\Easy\ASCIIArt\ASCIIArt
  * @group ASCIIArt
  */
 final class ASCIIArtTest extends PuzzleTest
@@ -26,7 +28,6 @@ public function setUp(): void
     /**
      * Test that the code can be executed for "Test only one letter: E".
      *
-     * @covers ::execute
      * @group ASCIIArt_onlyOneLetterE
      */
     public function testCanExecuteTestOnlyOneLetterE(): void
@@ -40,7 +41,6 @@ public function testCanExecuteTestOnlyOneLetterE(): void
     /**
      * Test that the code can be executed for "Test MANHATTAN".
      *
-     * @covers ::execute
      * @group ASCIIArt_testMANHATTAN
      */
     public function testCanExecuteTestMANHATTAN(): void
@@ -54,7 +54,6 @@ public function testCanExecuteTestMANHATTAN(): void
     /**
      * Test that the code can be executed for "Test ManhAtTan".
      *
-     * @covers ::execute
      * @group ASCIIArt_testManhAtTan
      */
     public function testCanExecuteTestDifferentCaseManhAtTan(): void
@@ -68,7 +67,6 @@ public function testCanExecuteTestDifferentCaseManhAtTan(): void
     /**
      * Test that the code can be executed for "Test M@NH@TT@N".
      *
-     * @covers ::execute
      * @group ASCIIArt_testM@NH@TT@N
      */
     public function testCanExecuteTestMatNHatTTatN(): void
@@ -82,7 +80,6 @@ public function testCanExecuteTestMatNHatTTatN(): void
     /**
      * Test that the code can be executed for "MANHATTAN with another ASCII representation".
      *
-     * @covers ::execute
      * @group ASCIIArt_MANHATTANWithAnotherASCIIRepresentation
      */
     public function testCanExecuteMANHATTANWithAnotherASCIIRepresentation(): void
@@ -96,7 +93,6 @@ public function testCanExecuteMANHATTANWithAnotherASCIIRepresentation(): void
     /**
      * Test that the code can be executed for "Test MAN HAT TAN".
      *
-     * @covers ::execute
      * @group ASCIIArt_TestMAN_HAT_TAN
      */
     public function testCanExecuteTestMAN_HAT_TAN(): void

tests/Training/Easy/Defibrillators/DefibrillatorsTest.php

@@ -8,7 +8,9 @@
 use CyrilVerloop\Codingame\Training\Easy\Defibrillators\Defibrillators;
 
 /**
- * @coversDefaultClass \CyrilVerloop\Codingame\Training\Easy\Defibrillators\Defibrillators
+ * Tests for the "Defibrillators" puzzle.
+ *
+ * @covers \CyrilVerloop\Codingame\Training\Easy\Defibrillators\Defibrillators
  * @group defibrillators
  */
 final class DefibrillatorsTest extends PuzzleTest
@@ -26,7 +28,6 @@ public function setUp(): void
     /**
      * Test that the code can be executed for "Example".
      *
-     * @covers ::execute
      * @group defibrillators_example
      */
     public function testCanExecuteExample(): void
@@ -40,7 +41,6 @@ public function testCanExecuteExample(): void
     /**
      * Test that the code can be executed for "Exact position".
      *
-     * @covers ::execute
      * @group defibrillators_exactPosition
      */
     public function testCanExecuteExactPosition(): void
@@ -54,7 +54,6 @@ public function testCanExecuteExactPosition(): void
     /**
      * Test that the code can be executed for "Complete file".
      *
-     * @covers ::execute
      * @group defibrillators_completeFile
      */
     public function testCanExecuteCompleteFile(): void
@@ -68,7 +67,6 @@ public function testCanExecuteCompleteFile(): void
     /**
      * Test that the code can be executed for "Complete file 2".
      *
-     * @covers ::execute
      * @group defibrillators_completeFile2
      */
     public function testCanExecuteCompleteFile2(): void