diff --git a/docs/changelog.md b/docs/changelog.md
index ef2a961..0562e93 100644
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -2,5 +2,32 @@
 sidebar_position: 12
 ---
 
+# Versions & changelog
+
+
+# Versioning
+
+Our versioning policy follows the [Semantic Versioning specification](https://semver.org/). 
+In our case, given a version `MAJOR.MINOR.PATCH`, we increment the:
+
+* `MAJOR` version when the data model of the Graph changes
+* `MINOR` version when the pipeline (e.g., different deduplication method, different implementation for an enrichment process) or the data sources change
+* `PATCH` version when the graph data are updated
+
+
 # Changelog
-<span className="todo">TODO</span>
\ No newline at end of file
+
+This section will document all notable changes for each graph version.
+
+
+## v5.0.0 - [date]
+
+### Added
+
+### Changed
+
+### Deprecated
+
+### Removed
+
+### Fixed