[STORM-3788] Add more comments in docker-to-squash.py

docker-to-squash.py is a long script and needs more comments to help understanding

See https://github.com/apache/storm/pull/3366#issuecomment-882596986

---
Originally reported by ethanli, imported from: Add more comments in docker-to-squash.py

• status: Open
  
• priority: Major
  
• resolution: Unresolved
  
• imported: 2025-01-24
  

Open docker-to-squash.py and review the discussion linked in the issue, especially the referenced pull request comment, to identify which parts of the long script need explanation. Add comments that clarify the script's key logic, with the work complete when its flow is easier to understand without changing behavior.

Written by the indexing model from the issue text.