Minor corrections in readme and changelog

Author: ilya-g

CHANGELOG.md

@@ -14,10 +14,11 @@
     * `PersistentList` extends `ImmutableList` and `PersistentCollection`, and provides modification operations
     * `PersistentSet` extends `ImmutableSet` and `PersistentCollection`, and provides modification operations
     * `PersistentMap` extends `ImmutableMap`, and provides modification operations and builder
-- `plus`, `minus` and `mutate` extension functions are available only persistent collections
+- `plus`, `minus` and `mutate` extension functions are available only for persistent collections
 - Deprecate `immutableXOf()` top-level functions and introduce `persistentXOf()` 
 - `toImmutableX()` extension functions return `ImmutableX`
 - Introduce `toPersistentX()` extension functions that return `PersistentX`
+- Document public API
 
 #### Replace PCollection-based prototypes with custom performant implementations
 

README.md

@@ -39,13 +39,13 @@ This library provides interfaces for immutable and persistent collections.
 | `PersistentMap.Builder` | `MutableMap` |
 
 
-To instantiate an empty persistent collection or a collection with the specified elements the functions 
-`persistentListOf`, `persistentSetOf`, and `persistentMapOf` can be used.
+To instantiate an empty persistent collection or a collection with the specified elements use the functions 
+`persistentListOf`, `persistentSetOf`, and `persistentMapOf`.
 
 The default implementations of `PersistentSet` and `PersistentMap`, which are returned by `persistentSetOf` and `persistentMapOf`,
 preserve the element insertion order during iteration. This comes at expense of maintaining more complex data structures.
 If the order of elements doesn't matter, the more efficient implementations returned by the functions 
-`persistentHashSetOf` and `persistentHashMapOf` could be used.
+`persistentHashSetOf` and `persistentHashMapOf` can be used.
 
 ### Operations