From 89eba3cd666964f07426fbbed6d23c75a2a3b4d5 Mon Sep 17 00:00:00 2001
From: Mateusz Pusz <mateusz.pusz@gmail.com>
Date: Wed, 13 Sep 2023 09:00:21 +0200
Subject: [PATCH] docs: additional code example added to the "Value-preserving
 conversions" chapter

---
 docs/users_guide/framework_basics/value_conversions.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/users_guide/framework_basics/value_conversions.md b/docs/users_guide/framework_basics/value_conversions.md
index 64778f18..5dd8b111 100644
--- a/docs/users_guide/framework_basics/value_conversions.md
+++ b/docs/users_guide/framework_basics/value_conversions.md
@@ -38,6 +38,14 @@ std::cout << q1.in(km) << '\n';
 quantity<si::kilo<si::metre>> q2 = q1;
 ```
 
+or
+
+```cpp
+auto q1 = 5 * m;
+std::cout << value_cast<double>(q1).in(km) << '\n';
+quantity<si::kilo<si::metre>> q2 = q1;  // double by default
+```
+
 !!! important
 
     The **mp-units** library follows [`std::chrono::duration`](https://en.cppreference.com/w/cpp/chrono/duration)