diff --git a/news/xonsh_refactoring.rst b/news/xonsh_refactoring.rst
index c9b61d190..f8922d325 100644
--- a/news/xonsh_refactoring.rst
+++ b/news/xonsh_refactoring.rst
@@ -1,10 +1,14 @@
 **Added:**
 
-* Starting form ``xonsh.api`` (#5383 #5538).
+* Created ``xonsh.api`` to use xonsh functionality in pure python code and downstream projects (#5383 #5538).
+  It's usable but don't treat this serios because it's mostly to move some functions into distinct
+  submodule to reflect the intention to have the API. We need review and improvements here.
 
 **Changed:**
 
 * Big refactoring of internal modules structure to give clear understanding of internal xonsh components (#5538).
+  E.g. if you have ``import xonsh.jobs`` convert this to ``import xonsh.procs.jobs``.
+  This kind of refactoring occurs once per many years.
 
 **Deprecated:**