Small update to the getting started doc

Just some ideas that may make some things a bit clearer.
please keep the $ - it's used everywhere.