diff --git a/docs/faq.rst b/docs/faq.rst
index 1c55f724..8b27dcdd 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -24,6 +24,10 @@ What is PlatformIO?
 
 Please refer to :ref:`what_is_pio`
 
+What is ``.pioenvs`` directory
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Please refer to :ref:`projectconf_pio_envs_dir`.
 
 Command completion in Terminal
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/projectconf.rst b/docs/projectconf.rst
index 00168b59..b38954ec 100644
--- a/docs/projectconf.rst
+++ b/docs/projectconf.rst
@@ -97,7 +97,7 @@ This option can be overridden by global environment variable
 ``envs_dir``
 ^^^^^^^^^^^^
 
-*PlatformIO Builder* within :ref:`cmd_run` command uses this folder for project
+This is a cache directory. *PlatformIO Build System* uses this folder for project
 environments to store compiled object files, static libraries, firmwares and
 other cached information. It allows PlatformIO to build source code extremely
 fast!