Add additional comments to the ML notebook and ensure its easy to align with datapreprocessing

[scottcha]

1. Ensure notebook is fully documented
2. Investigate removing the inline variables or at least make it easier for a user to set them to appropriate values.