doc: move the documentation from the README file to /docs

[annastuchlik]

Now that we can publish the documentation at https://gocql-driver.docs.scylladb.com/stable/index.html, we should move the documentation from the README file to the source files for the website - in the /docs folder.