doc: improve description of MemoryMap

Author: phip1611

uefi/src/table/boot.rs

@@ -1793,15 +1793,22 @@ impl MemoryMapMeta {
     }
 }
 
-/// An accessory to the UEFI memory map that can be either iterated or indexed
-/// like an array.
+/// An accessory to the UEFI memory map and associated metadata that can be 
+/// either iterated or indexed like an array.
 ///
 /// A [`MemoryMap`] is always associated with the unique [`MemoryMapKey`]
-/// bundled with the ma.
+/// bundled with the map.
 ///
 /// To iterate over the entries, call [`MemoryMap::entries`].
 ///
 /// ## UEFI pitfalls
+/// Note that a MemoryMap can quickly become outdated, as soon as any explicit
+/// or hidden allocation happens.
+/// 
+/// As soon as boot services are excited, all previous obtained memory maps must
+/// be considered as outdated, except if the [`MemoryMapKey`] equals the one
+/// returned by `exit_boot_services()`.
+/// 
 /// **Please note** that when working with memory maps, the `entry_size` is
 /// usually larger than `size_of::<MemoryDescriptor` [[0]]. So to be safe,
 /// always use `entry_size` as step-size when interfacing with the memory map on