MAGETWO-64226: Add paths validation

Author: shiftedreality

app/code/Magento/Config/Model/Config/PathValidator.php

@@ -28,10 +28,10 @@ public function __construct(Structure $structure)
     }
 
     /**
-     * Validates the config path by config structure schema.
+     * Checks whether the config path present in configuration structure.
      *
      * @param string $path The config path
-     * @return bool The result of validation
+     * @return true The result of validation
      * @throws ValidatorException If provided path is not valid
      */
     public function validate($path)

app/code/Magento/Config/Model/Config/Structure.php

@@ -252,8 +252,8 @@ protected function _getGroupFieldPathsByAttribute(array $fields, $parentPath, $a
     }
 
     /**
-     * Collects config field paths recursively from config schema.
-     * Returns an array map of fields specification.
+     * Collects config paths and their structure paths from configuration files.
+     * Returns the map of config paths and their structure paths.
      *
      * ```php
      *  [
@@ -272,7 +272,7 @@ public function getFieldPaths()
     }
 
     /**
-     * Iteration that collects config field paths recursively from config schema.
+     * Iteration that collects config field paths recursively from config files.
      *
      * @param array $elements The elements to be parsed
      * @return array An array of config path to config structure path map