Repository: Project-MONAI/MONAI

Issue:
improve ConfigParser documentation
**Is your feature request related to a problem? Please describe.**
the usage of `ConfigParser` methods `read_config`, `load_config_file`, `load_config_files` are not straightforward, would be great to clarify that
- `parser.read_config` is an instance method that could take key-value pairs and override existing `parser`'s config.
- `ConfigParser.load_config_file` is a class method for loading a single json/yaml file
- `ConfigParser.load_config_files` is a class method for loading multiple config files and combine the config contents
improve ConfigParser documentation
**Is your feature request related to a problem? Please describe.**
the usage of `ConfigParser` methods `read_config`, `load_config_file`, `load_config_files` are not straightforward, would be great to clarify that
- `parser.read_config` is an instance method that could take key-value pairs and override existing `parser`'s config.
- `ConfigParser.load_config_file` is a class method for loading a single json/yaml file
- `ConfigParser.load_config_files` is a class method for loading multiple config files and combine the config contents


Discussion:

Resolving patch:
diff --git a/monai/bundle/config_parser.py b/monai/bundle/config_parser.py
--- a/monai/bundle/config_parser.py
+++ b/monai/bundle/config_parser.py
@@ -305,8 +305,8 @@ def read_meta(self, f: PathLike | Sequence[PathLike] | dict, **kwargs: Any) -> N
 
     def read_config(self, f: PathLike | Sequence[PathLike] | dict, **kwargs: Any) -> None:
         """
-        Read the config from specified JSON or YAML file.
-        The config content in the `self.config` dictionary.
+        Read the config from specified JSON/YAML file or a dictionary and
+        override the config content in the `self.config` dictionary.
 
         Args:
             f: filepath of the config file, the content must be a dictionary,
@@ -383,7 +383,7 @@ def _do_parse(self, config: Any, id: str = "") -> None:
     @classmethod
     def load_config_file(cls, filepath: PathLike, **kwargs: Any) -> dict:
         """
-        Load config file with specified file path (currently support JSON and YAML files).
+        Load a single config file with specified file path (currently support JSON and YAML files).
 
         Args:
             filepath: path of target file to load, supported postfixes: `.json`, `.yml`, `.yaml`.
@@ -405,13 +405,15 @@ def load_config_file(cls, filepath: PathLike, **kwargs: Any) -> dict:
     @classmethod
     def load_config_files(cls, files: PathLike | Sequence[PathLike] | dict, **kwargs: Any) -> dict:
         """
-        Load config files into a single config dict.
+        Load multiple config files into a single config dict.
         The latter config file in the list will override or add the former config file.
         ``"::"`` (or ``"#"``) in the config keys are interpreted as special characters to go one level
         further into the nested structures.
 
         Args:
             files: path of target files to load, supported postfixes: `.json`, `.yml`, `.yaml`.
+                if providing a list of files, wil merge the content of them.
+                if providing a dictionary, return it directly.
             kwargs: other arguments for ``json.load`` or ```yaml.safe_load``, depends on the file format.
         """
         if isinstance(files, dict):  # already a config dict


Test patch: