improve installation instructions and other docs