Revert "Revert "Improve the README file""

This reverts commit 3ed3c0782ea0140a4b750e493bb16399ff5158e6.