extended readme + minimal syntax fixes