prepare release 0.4.0

CHANGELOG.md

@@ -5,10 +5,29 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## Unreleased
+
+## [0.4.0](https://github.com/dspicher/ur-rs/releases/tag/0.4.0) - 2023-08-04
  - Added support for `no-std` environments. https://github.com/dspicher/ur-rs/pull/183
- - Introduced a type-safe `ur::Type` enum and a `ur::Encoder::bytes` shorthand constructor. https://github.com/dspicher/ur-rs/pull/186
+ - Introduced a type-safe `ur::Type` enum and a `ur::Encoder::bytes` shorthand constructor (see the below migration guide). https://github.com/dspicher/ur-rs/pull/186
  - Added `wasm` example. https://github.com/dspicher/ur-rs/pull/191
 
+### Migration guide
+
+Replace `Encoder` constructors with `bytes` schemes:
+```rust
+ur::Encoder::new(data, max_length, "bytes")
+```
+
+with:
+```rust
+ur::Encoder::bytes(data, max_length)
+```
+
+Leave all other `Encoder` constructors as they are:
+```rust
+ur::Encoder::new(data, max_length, "my-scheme")
+```
+
 ## [0.3.0](https://github.com/dspicher/ur-rs/releases/tag/0.3.0) - 2023-01-07
  - Added `ur::ur::decode` to the public API to decode a single `ur` URI. https://github.com/dspicher/ur-rs/pull/112
  - Added `ur::ur::encode` and `ur::ur::decode` to the root library path. https://github.com/dspicher/ur-rs/pull/112

Cargo.toml

@@ -5,7 +5,7 @@ members = ["examples/wasm", "fuzz"]
 name = "ur"
 description = "A Rust implementation of Uniform Resources"
 license = "MIT"
-version = "0.3.0"
+version = "0.4.0"
 authors = ["Dominik Spicher <dominikspicher@gmail.com>"]
 edition = "2021"
 repository = "https://github.com/dspicher/ur-rs/"