Update cli/flox-rust-sdk/src/models/environment/managed_environment.rs

Co-authored-by: Matthew Kenigsberg <matthew@floxdev.com>

cli/flox-rust-sdk/src/models/environment/managed_environment.rs

@@ -962,7 +962,14 @@ impl ManagedEnvironment {
         let project_branch = branch_name(&self.pointer, &self.path);
         let sync_branch = remote_branch_name(&self.pointer);
 
-        // ensure the environment builds before we push it
+        // Ensure the environment builds before we push it
+        // Usually we don't create generations unless they build,
+        // but that is not always the case.
+        // If a user pulls an environment that is broken on their system, we may
+        // create a "broken" generation.
+        // That generation could have a divergent manifest and lock,
+        // or it could fail to build.
+        // So we have to verify we don't have a "broken" generation before pushing.
         {
             let mut env = self.get_current_generation(flox)?;
             env.build(flox).map_err(ManagedEnvironmentError::Build)?;