README.adoc in refinements-12.0.1 vs README.adoc in refinements-12.1.0
- old
+ new
@@ -374,22 +374,26 @@
[1, "a", :b, 2.0, /\w+/].to_sentence # "1, a, b, 2.0, and (?-mix:\\w+)"
%w[one two three].to_sentence # "one, two, and three"
%w[eins zwei drei].to_sentence "und", delimiter: " " # "eins zwei und drei"
----
+💡 You can use a string or a symbol for the conjunction (i.e. `"and"` or `:and`).
+
===== #to_usage
-Builds upon and enhances `#to_sentence` further by answering a sentence which all elements are inspected -- where each element of the array is called with `#inspect` -- before turned into a sentence using `"and"` as the default conjunction and `", "` as the default delimiter. This is useful when providing detailed error messages _and_ you need to detail the types of element used.
+Further enhances `#to_sentence` by answering a sentence where all elements are inspected (i.e. `#inspect`) before turned into a sentence using `"and"` as the default conjunction and `", "` as the default delimiter. This is useful when providing detailed error messages _and_ you need the _types_ of all elements preserved.
[source,ruby]
----
[].to_usage # ""
["demo"].to_usage # "\"demo\""
["a", :b].to_usage # "\"a\" and :b"
[1, "a", :b, 2.0, /\w+/].to_usage # "1, \"a\", :b, 2.0, and /\\w+/"
%w[one two three].to_usage # "\"one\", \"two\", and \"three\""
%w[eins zwei drei].to_usage "und", delimiter: " " # "\"eins\" \"zwei\" und \"drei\""
----
+
+💡 You can use a string or a symbol for the conjunction (i.e. `"and"` or `:and`).
==== Data
===== #diff