Use less vague language

cranelift/frontend/src/variable.rs

@@ -3,10 +3,10 @@
 //! Frontends can use any indexing scheme they see fit and
 //! generate the appropriate `Variable` instances.
 //!
-//! Note: The `Variable` is used by Cranelift to index an array containing
+//! Note: The `Variable` is used by Cranelift to index into densely allocated
-//! information about your mutable variables. Thus, when you create a new
+//! arrays containing information about your mutable variables
-//! `Variable` you should make sure that the index is provided by a counter
+//! Thus, make sure that Variable's indexes are allocated contiguously and
-//! incremented by 1 each time you encounter a new mutable variable.
+//! starting at `0`.
 
 use core::u32;
 use cranelift_codegen::entity::EntityRef;