diff --git a/docs/projectconf.rst b/docs/projectconf.rst
index bf741fe4..de21b0a6 100644
--- a/docs/projectconf.rst
+++ b/docs/projectconf.rst
@@ -122,7 +122,7 @@ Options
 ``platform``
 ^^^^^^^^^^^^
 
-:ref:`Platform <platforms>` type
+:ref:`Platform <platforms>` type.
 
 
 .. _projectconf_env_framework:
@@ -130,7 +130,9 @@ Options
 ``framework``
 ^^^^^^^^^^^^^
 
-See ``framework`` type in *Frameworks* section of :ref:`platforms`
+:ref:`Framework <frameworks>` type.
+
+The multiple frameworks are allowed, split them with comma ``,`` separator.
 
 
 .. _projectconf_env_board: