diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..bf61e0c
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,58 @@
+# 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-04
+
+### Added
+
+- *(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
+
+- *(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
+
+- 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 4d544d9..0e0a51b 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"