add more comments

kstorage/src/commonMain/kotlin/ru/astrainteractive/klibs/kstorage/api/value/ValueSaver.kt

@@ -2,6 +2,7 @@ package ru.astrainteractive.klibs.kstorage.api.value
 
 fun interface ValueSaver<T> {
     fun save(value: T)
+
     class Empty<T> : ValueSaver<T> {
         override fun save(value: T) = Unit
     }

kstorage/src/commonMain/kotlin/ru/astrainteractive/klibs/kstorage/suspend/SuspendKrate.kt

@@ -1,7 +1,14 @@
 package ru.astrainteractive.klibs.kstorage.suspend
 
+import ru.astrainteractive.klibs.kstorage.api.Krate
 import ru.astrainteractive.klibs.kstorage.api.cache.CacheOwner
 
+/**
+ * Same as [Krate], [SuspendKrate] is a wrapper for your favorite key-value storage library
+ */
 interface SuspendKrate<T> : CacheOwner<T> {
+    /**
+     * Load value from storage and update [cachedValue]
+     */
     suspend fun loadAndGet(): T
 }

kstorage/src/commonMain/kotlin/ru/astrainteractive/klibs/kstorage/suspend/SuspendMutableKrate.kt

@@ -1,7 +1,19 @@
 package ru.astrainteractive.klibs.kstorage.suspend
 
+import ru.astrainteractive.klibs.kstorage.api.MutableKrate
+
+/**
+ * Same as [MutableKrate], [SuspendMutableKrate] allows you to save/load values from your storage without
+ * depending on SharedPreferences or other library
+ */
 interface SuspendMutableKrate<T> : SuspendKrate<T> {
+    /**
+     * Save new value into storage and update current
+     */
     suspend fun save(value: T)
 
+    /**
+     * Reset value to default
+     */
     suspend fun reset()
 }

kstorage/src/commonMain/kotlin/ru/astrainteractive/klibs/kstorage/suspend/value/FlowProvider.kt

@@ -2,6 +2,9 @@ package ru.astrainteractive.klibs.kstorage.suspend.value
 
 import kotlinx.coroutines.flow.Flow
 
+/**
+ * [FlowProvider] should provide you with flow. Use android.DataStore, for example
+ */
 fun interface FlowProvider<out T> {
     fun provide(): Flow<T?>
 }