declaring missing private vars and start documenting functions