adding some docs to the harmonic oscillator example