docs: add explanation of modes

In general we use the term machine everywhre.