diff --git a/nimble-guide/docs/create-packages.md b/nimble-guide/docs/create-packages.md
index 51184d0d3..42b4c405f 100644
--- a/nimble-guide/docs/create-packages.md
+++ b/nimble-guide/docs/create-packages.md
@@ -214,14 +214,11 @@ when defined(windows):
   requires "puppy 1.5.4"
 ```
 
-### Declarative Parser (Experimental)
+### Declarative Parser
 
-Starting in `nimble 0.18.0`, the declarative parser can be used.  
-It can be activated using the flag `--parser:declarative` and will become the default parser in the future.  
-
-The main advantage of the declarative parser is deterministic dependencies, allowing `nimble` to build a reliable cache.  
-Another benefit is improved speed, as there is no need to spin up the Nim VM for every dependency.
+Starting with `nimble 0.18.0` and up to `0.22.3`, the declarative parser can be used using `--parser:declarative` flag, offering better speed and reliability in dependency resolution.
 
+In `nimble 0.24.0`, the declarative parser became the default and only user-selectable parser, replacing the legacy Nim VM parser for normal operation. The Nim VM parser is retained solely as an automatic compatibility fallback.
 ---
 
 ### Features (Experimental)