Document better usability

README.md

@@ -36,3 +36,30 @@ Using Stern is simply:
       }
   }
 ```
+
+## Docblock Usability 
+
+For better usability (especially with type-aware IDEs like PHPStorm), make sure
+you use [`@method`](https://docs.phpdoc.org/references/phpdoc/tags/method.html)
+docblocks.
+
+```diff
+  <?php
+  declare(strict_types=1);
+  namespace YourVendor\YourNamespace;
+
++   /**
++    * @method bool foo(string $param = '')
++    */
+  class YourClassThatUsesStrictTypes
+  {
++      use \ParagonIE\Stern\SternTrait;
+
+      /* ... */
+
+-     public function foo(string $param = ''): bool
++     public function strictFoo(string $param = ''): bool
+      {
+      }
+  }
+```

tests/test-classes/Weak.php

@@ -7,6 +7,11 @@
 /**
  * Class Weak
  * @package ParagonIE\SternTests
+ *
+ * @method bool weakBool(bool $isWeak = false)
+ * @method string weakString(string $str = '')
+ * @method float weakFloat(float $f)
+ * @method int weakInt(int $int)
  */
 class Weak
 {
@@ -34,7 +39,7 @@ protected function strictWeakString(string $str = ''): string
      * @param float $f
      * @return float
      */
-    protected function strictWeakFloat(float $f)
+    protected function strictWeakFloat(float $f): float
     {
         return $f;
     }
@@ -43,7 +48,7 @@ protected function strictWeakFloat(float $f)
      * @param int $int
      * @return int
      */
-    protected function strictWeakInt(int $int)
+    protected function strictWeakInt(int $int): int
     {
         return $int + 1;
     }