chore(doc): added comments to the main engine code

- No functional changes here, just comments and small refactoring.

Author: V0ldek