diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..fd1cf2f
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,89 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+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]
+
+## [2.0.0](https://git.kemitix.net/kemitix/kxio/compare/v1.2.0...v2.0.0) - 2024-11-14
+
+### Added
+
+- *(net)* mock matcher no longer uses a prebuilt request
+- *(net)* cleaner mock.on syntax
+- *(net)* be more permisive in what parameters are accepted
+- *(fs)* `kxio::fs::new(...)` now accepts `impl Into<PathBuf>`
+- Net and MockNet wrappers for InnerNet<Mocker> and InnerNet<Unmocked>
+- Net<Mocked> uses internal mutability
+- add kxio::Result;
+- *(network)* [**breaking**] remove legacy network interface
+- *(net)* [**breaking**] fluent api
+- *(fs)* add .path(path).read_link()
+- *(fs)* add .path(path).set_permissions(perms)
+- *(fs)* add .path(path).symlink_metadata()
+- *(fs)* add .path(path).canonicalize()
+- *(fs)* add .path(path).soft_link(other), .path(path).is_link()
+- *(fs)* add .path(path).metadata()
+- *(fs)* add .file(path).hard_link(path)
+- *(fs)* add .path(path).rename()
+- *(fs)* add .file(path).remove()
+- *(fs)* add .dir(path).remove_all()
+- *(fs)* add .dir(path).remove()
+- *(fs)* add .reader().bytes()
+- *(fs)* add .copy(dest)
+- remove need for mutability
+- *(fs)* add lines to reader
+- *(fs)* add as_dir/as_file to convert from path
+- *(fs)* [**breaking**] remove legacy filesystem module
+- *(fs)* [**breaking**] new fluent API
+- network: add from impl to help discard unit NetResponses
+
+### Fixed
+
+- *(fs)* make TempFileSystem public
+- use Default to create reqwest client
+- *(deps)* update rust crate thiserror to v2
+- *(deps)* update rust crate secrecy to 0.10
+- *(deps)* update rust crate secrecy to 0.10
+- *(deps)* update rust crate derive_more to 1.0.0-beta
+
+### Other
+
+- *(deps)* update kemitix/rust action to v2.4.1
+- add cargo-mutants step
+- bump rust image to 2.4.1
+- *(net)* fix gramar
+- *(net)* remove inner from Net
+- *(net)* added
+- *(fs)* minor tidy up broken links
+- *(examples)* add annotations to the `get` example
+- *(readme)* write a proper readme
+- add cargo mutants to local dev test build step
+- *(example)* get and save
+- ignore cargo-mutants output
+- *(fs)* add more test
+- *(fs)* PathReal owns its own data
+- *(fs)* make it clearer what the std::fs functions map to
+- *(fs)* move checklist/std::fs mapping to rustdoc
+- regroup integration tests into modules
+- *(fs)* use type aliases
+- *(fs)* use type aliases
+- *(readme)* apply formatting to std::fs::* todo list
+- *(readme)* reformat todo list for std::fs::*
+- cleanup
+- use generics for path type
+- update readme
+- remove unit tests
+- split real module into sub-modules
+- move new fns to their struct
+- *(fs)* integration tests
+- extract result module
+- verify path_of normal behaviour
+- switch to forgejo actions
+- *(deps)* update docker.io/rust docker tag to v1.81
+- *(deps)* update docker.io/rust docker tag to v1.80
+- *(deps)* update docker.io/woodpeckerci/plugin-docker-buildx docker tag to v4.2
+- *(deps)* update docker.io/woodpeckerci/plugin-docker-buildx docker tag to v4.1
+- *(deps)* update docker.io/rust docker tag to v1.79
diff --git a/Cargo.toml b/Cargo.toml
index a954d4b..f148ad5 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "kxio"
-version = "1.2.0"
+version = "2.0.0"
 edition = "2021"
 authors = ["Paul Campbell <pcampbell@kemitix.net>"]
 description = "Provides injectable Filesystem and Network resources to make code more testable"