@@ -14,3 +14,8 @@ Changelog
 .. towncrier-draft-entries:: |release| [UNRELEASED DRAFT]
 
 .. towncrier release notes start
+
+0.1.0 (2023-12-01)
+===================
+
+Initial project release. To see all changes and improvements compared to Pyrogram, see `Hydrogram vs Pyrogram <https://hydrogram.amanoteam.com/en/latest/hydrogram-vs-pyrogram.html>`_
@@ -0,0 +1,28 @@
+Hydrogram vs Pyrogram
+=====================
+
+Introduction
+------------
+
+This is a non-exhaustive list of differences between Hydrogram and Pyrogram.
+It is updated periodically.
+
+Changes
+-------
+
+- Support for the latest layer
+- Support for threads/topics
+- Improvements in IDE support by declaring ``__all__`` in files
+- Mark optional parameters in methods as keyword-only, to avoid future breakage when adding new parameters
+- Use of newer packaging technologies and standards, such as pyproject.toml
+- Use of aiosqlite instead of sqlite3
+- Open-source documentation
+- More active development
+- Completely refactored, optimized and modernized codes (Using Ruff)
+
+Fixes
+-----
+
+- Add FloodWait exception to media download
+- Fixed a bug that would treat `0`, `False` or `None` as an empty message
+- Fixed minor code issues
@@ -76,6 +76,7 @@ First Steps
 .. hlist::
     :columns: 1
 
+    - :doc:`Migration Guide <start/migration-guide>`: Migration guide from Pyrogram.
     - :doc:`Quick Start <intro/quickstart>`: Overview to get you started quickly.
     - :doc:`Invoking Methods <start/invoking>`: How to call Hydrogram's methods.
     - :doc:`Handling Updates <start/updates>`: How to handle Telegram updates.
@@ -102,6 +103,7 @@ Meta
     - :doc:`Hydrogram FAQ <faq/index>`: Answers to common Hydrogram questions.
     - :doc:`Support Hydrogram <support>`: Ways to show your appreciation.
     - :doc:`Release Notes <releases>`: Release notes for Hydrogram releases.
+    - :doc:`Hydrogram vs Pyrogram <hydrogram-vs-pyrogram>`: Comparison between Hydrogram and Pyrogram.
 
 .. toctree::
     :hidden:
@@ -164,6 +166,7 @@ Meta
     faq/index
     support
     releases
+    hydrogram-vs-pyrogram
 
 .. toctree::
     :hidden: