diff --git a/src/block/BaseRail.php b/src/block/BaseRail.php
index cff41ea3d6..487a59cbd5 100644
--- a/src/block/BaseRail.php
+++ b/src/block/BaseRail.php
@@ -109,6 +109,10 @@ abstract class BaseRail extends Flowable{
 		$this->tryReconnect();
 	}
 
+	/**
+	 * @param int[]   $connections
+	 * @param int[][] $lookup
+	 */
 	protected static function searchState(array $connections, array $lookup) : int{
 		$meta = array_search($connections, $lookup, true);
 		if($meta === false){
@@ -124,6 +128,8 @@ abstract class BaseRail extends Flowable{
 	/**
 	 * Returns a meta value for the rail with the given connections.
 	 *
+	 * @param int[] $connections
+	 *
 	 * @throws \InvalidArgumentException if no state matches the given connections
 	 */
 	protected function getMetaForState(array $connections) : int{
@@ -170,6 +176,11 @@ abstract class BaseRail extends Flowable{
 		return $connections;
 	}
 
+	/**
+	 * @param int[] $constraints
+	 *
+	 * @return true[]
+	 */
 	private function getPossibleConnectionDirections(array $constraints) : array{
 		switch(count($constraints)){
 			case 0:
@@ -194,6 +205,9 @@ abstract class BaseRail extends Flowable{
 		}
 	}
 
+	/**
+	 * @return true[]
+	 */
 	protected function getPossibleConnectionDirectionsOneConstraint(int $constraint) : array{
 		$opposite = Facing::opposite($constraint & ~self::FLAG_ASCEND);
 
@@ -255,6 +269,9 @@ abstract class BaseRail extends Flowable{
 		}
 	}
 
+	/**
+	 * @param int[] $connections
+	 */
 	private function setConnections(array $connections) : void{
 		if(count($connections) === 1){
 			$connections[] = Facing::opposite($connections[0] & ~self::FLAG_ASCEND);
diff --git a/src/block/Leaves.php b/src/block/Leaves.php
index 59b2a3c375..638a78ebcf 100644
--- a/src/block/Leaves.php
+++ b/src/block/Leaves.php
@@ -67,6 +67,9 @@ class Leaves extends Transparent{
 		return true;
 	}
 
+	/**
+	 * @param true[] $visited reference parameter
+	 */
 	protected function findLog(Vector3 $pos, array &$visited = [], int $distance = 0) : bool{
 		$index = World::blockHash($pos->x, $pos->y, $pos->z);
 		if(isset($visited[$index])){