Slightly cleaned up documentation
Update README with known bug