update README with convention notes