diff --git a/mne/io/meas_info.py b/mne/io/meas_info.py index 956dedf91cc..0d48a5642c9 100644 --- a/mne/io/meas_info.py +++ b/mne/io/meas_info.py @@ -184,14 +184,19 @@ class Info(dict, MontageMixin): """Measurement information. This data structure behaves like a dictionary. It contains all metadata - that is available for a recording. - - This class should not be instantiated directly. To create a measurement - information strucure, use :func:`mne.create_info`. + that is available for a recording. However, its keys are restricted to + those provided by the + `FIF format specification `__, + so new entries should not be manually added. The only entries that should be manually changed by the user are ``info['bads']`` and ``info['description']``. All other entries should - be considered read-only, or should be modified by functions or methods. + be considered read-only, though they can be modified by various MNE-Python + functions or methods (which have safeguards to ensure all fields remain in + sync). + + This class should not be instantiated directly. To create a measurement + information strucure, use :func:`mne.create_info`. Attributes ----------