diff --git a/src/main/kotlin/ru/dbotthepony/mc/otm/core/math/BlockRotation.kt b/src/main/kotlin/ru/dbotthepony/mc/otm/core/math/BlockRotation.kt
index c484b2441..cefba788a 100644
--- a/src/main/kotlin/ru/dbotthepony/mc/otm/core/math/BlockRotation.kt
+++ b/src/main/kotlin/ru/dbotthepony/mc/otm/core/math/BlockRotation.kt
@@ -26,7 +26,11 @@ operator fun BlockPos.plus(other: BlockRotation): BlockPos {
 }
 
 /**
- * [top] clarifies about block's top facing direction, NOT bottom
+ * Represents unique block orientation in space, by providing [front] and [top] directions
+ *
+ * Allows to get relative faces through [left], [right], [bottom] and [back]
+ *
+ * @see BlockRotationFreedom
  */
 enum class BlockRotation(
 	val front: Direction,
diff --git a/src/main/kotlin/ru/dbotthepony/mc/otm/core/math/BlockRotationFreedom.kt b/src/main/kotlin/ru/dbotthepony/mc/otm/core/math/BlockRotationFreedom.kt
index cb479a34d..efe3ef08a 100644
--- a/src/main/kotlin/ru/dbotthepony/mc/otm/core/math/BlockRotationFreedom.kt
+++ b/src/main/kotlin/ru/dbotthepony/mc/otm/core/math/BlockRotationFreedom.kt
@@ -14,6 +14,9 @@ internal inline val BlockState.facingOne: Direction get() = this[BlockRotationFr
 internal inline val BlockState.facingTwo: Direction get() = this[BlockRotationFreedom.TWO.property].front
 internal inline val BlockState.facingThree: Direction get() = this[BlockRotationFreedom.THREE.property].front
 
+/**
+ * Controls the rotational freedom of block in space, employing [property] and [of] to get valid value from set of possible values
+ */
 enum class BlockRotationFreedom(vararg values: BlockRotation) {
 	ONE(
 		BlockRotation.NORTH,