Some inline code comments for beginners

The program panics when the keyspace or table was not available. The querying
part failed when an index was not prebuilt.

These information may be common knowledge for Cassandra experts. But I was a
beginner who was considering cassandra and gocql over sqlite and had to spend
time finding these pre-requisite cql instructions myself. Since it is the basic
example, Documenting these CQL queries will help beginners.

AUTHORS

@@ -28,3 +28,4 @@ Ben Frye <[email protected]>
 Fred McCann <[email protected]>
 Dan Simmons <[email protected]>
 Muir Manders <[email protected]>
+Sankar P <[email protected]>

README.md

@@ -86,6 +86,11 @@ Example
 -------
 
 ```go
+/* Before you execute the program, Launch `cqlsh` and execute:
+create keyspace example with replication = { 'class' : 'SimpleStrategy', 'replication_factor' : 1 };
+create table example.tweet(timeline text, id UUID, text text, PRIMARY KEY(id));
+create index on example.tweet(timeline);
+*/
 package main
 
 import (
@@ -112,7 +117,9 @@ func main() {
 	var id gocql.UUID
 	var text string
 
-	// select a single tweet
+	/* Search for a specific set of records whose 'timeline' column matches
+	 * the value 'me'. The secondary index that we created earlier will be
+	 * used for optimizing the search */
 	if err := session.Query(`SELECT id, text FROM tweet WHERE timeline = ? LIMIT 1`,
 		"me").Consistency(gocql.One).Scan(&id, &text); err != nil {
 		log.Fatal(err)