changes to scratch buffer on init and documentation