diff --git a/base/sysinfo.jl b/base/sysinfo.jl
index 040163fa80a5b..8f9d791f31ddd 100644
--- a/base/sysinfo.jl
+++ b/base/sysinfo.jl
@@ -22,7 +22,9 @@ global CPU_CORES
 """
     Sys.CPU_CORES
 
-The number of CPU cores in the system.
+The number of logical CPU cores available in the system.
+
+See the Hwloc.jl package for extended information, including number of physical cores.
 """
 :CPU_CORES
 
diff --git a/doc/stdlib/constants.rst b/doc/stdlib/constants.rst
index e8530a79f0d41..73ac34029a17e 100644
--- a/doc/stdlib/constants.rst
+++ b/doc/stdlib/constants.rst
@@ -55,7 +55,9 @@ Constants
 
    .. Docstring generated from Julia source
 
-   The number of CPU cores in the system.
+   The number of logical CPU cores available in the system.
+
+   See the Hwloc.jl package for extended information, including number of physical cores.
 
 .. data:: Sys.WORD_SIZE