Add disclaimer on bytearray.to_string

Author: KtorZ

lib/aiken/bytearray.ak

@@ -387,8 +387,14 @@ test take_4() {
 
 /// Convert a `ByteArray` into a `String`.
 ///
+/// <br/>⚠️<pre>WARNING</pre> | This functions fails if the underlying `ByteArray` isn't UTF-8-encoded. <br/>In particular, you cannot convert arbitrary hash digests using this function. <br/>For converting arbitrary `ByteArray`s, use [bytearray.to_hex](#to_hex).
+/// ---                  | ---
+///
+///
 /// ```aiken
 /// bytearray.to_string(#"414243") == "ABC"
+///
+/// bytearray.to_string(some_hash) -> fail
 /// ```
 pub fn to_string(self: ByteArray) -> String {
   builtin.decode_utf8(self)