CHANGELOG: simplify the formatting and document YamlLoader::documents()

saphyr/CHANGELOG.md

@@ -1,16 +1,18 @@
 # Changelog
 
 ## Upcoming
-### Breaking changes
+
+**Breaking Changes**:
+
 - The `encoding` library has been replaced with `encoding_rs`. If you use the
 `trap` of `YamlDecoder`, this change will make your code not compile.
 An additional enum `YamlDecoderTrap` has been added to abstract the
 underlying library and avoid breaking changes in the future. This
 additionally lifts the `encoding` dependency on _your_ project if you were
 using that feature.
-   - The `encoding::types::DecoderTrap` has been replaced with `YamlDecoderTrap`.
   - The signature of the function for `YamlDecoderTrap::Call` has changed:
-     ```rs
+  - The `encoding::types::DecoderTrap` has been replaced with `YamlDecoderTrap`.
+    ```rust
     // Before, with `encoding::types::DecoderTrap::Call`
     fn(_: &mut encoding::RawDecoder, _: &[u8], _: &mut encoding::StringWriter) -> bool;
     // Now, with `YamlDecoderTrap::Call`
@@ -21,10 +23,13 @@
 **Features**:
 
 - Tags can now be retained across documents by calling `keep_tags(true)` on a
-  `yaml_rust2::Parser` before loading documents.
+`Parser` before loading documents.
 ([#10](https://github.com/Ethiraric/yaml-rust2/issues/10)
 ([#12](https://github.com/Ethiraric/yaml-rust2/pull/12))
 
+- `YamlLoader` structs now have a `documents()` method that returns the parsed
+documents associated with a loader.
+
 **Development**:
 
 ## v0.7.0