readme syntax and interpretation details