minor fix
adds convention of url variables
improve conventions section
improve status codes section