improve readme format, block variable scope clarified