[STORM-1486] Fix storm-kafa documentation
[STORM-1486] Fix storm-kafa documentation

Fix storm-kafka documentation to reflect changes from STORM-1220 and also
document the version incompatiblity of pre 1.x kafka-spout with storm 1.0 and later.

hmcc/storm,roshannaik/storm,hmcl/storm-apache,F30/storm,Crim/storm,srdo/storm,hmcc/storm,carl34/storm,F30/storm,cluo512/storm,srishtyagrawal/storm,0x726d77/storm,erikdw/storm,knusbaum/incubator-storm,srishtyagrawal/storm,raviperi/storm,srdo/storm,erikdw/storm,hmcl/storm-apache,Crim/storm,kevinconaway/storm,srishtyagrawal/storm,ujfjhz/storm,Crim/storm,kishorvpatil/incubator-storm,kevpeek/storm,cluo512/storm,cluo512/storm,raviperi/storm,kevinconaway/storm,kishorvpatil/incubator-storm,kamleshbhatt/storm,Crim/storm,ujfjhz/storm,ujfjhz/storm,kevinconaway/storm,hmcl/storm-apache,kevpeek/storm,ujfjhz/storm,0x726d77/storm,carl34/storm,ujfjhz/storm,kamleshbhatt/storm,0x726d77/storm,carl34/storm,roshannaik/storm,carl34/storm,pczb/storm,kamleshbhatt/storm,kevinconaway/storm,kamleshbhatt/storm,hmcl/storm-apache,pczb/storm,cluo512/storm,raviperi/storm,srdo/storm,kishorvpatil/incubator-storm,srdo/storm,kishorvpatil/incubator-storm,hmcc/storm,raviperi/storm,erikdw/storm,hmcc/storm,erikdw/storm,F30/storm,adityasharad/storm,kevinconaway/storm,0x726d77/storm,carl34/storm,ujfjhz/storm,adityasharad/storm,srishtyagrawal/storm,roshannaik/storm,0x726d77/storm,cluo512/storm,carl34/storm,knusbaum/incubator-storm,raviperi/storm,knusbaum/incubator-storm,knusbaum/incubator-storm,knusbaum/incubator-storm,hmcc/storm,kamleshbhatt/storm,adityasharad/storm,raviperi/storm,kamleshbhatt/storm,pczb/storm,hmcl/storm-apache,Crim/storm,kevpeek/storm,raviperi/storm,kevpeek/storm,F30/storm,sakanaou/storm,Crim/storm,knusbaum/incubator-storm,hmcl/storm-apache,hmcl/storm-apache,Crim/storm,sakanaou/storm,F30/storm,roshannaik/storm,F30/storm,roshannaik/storm,srishtyagrawal/storm,sakanaou/storm,erikdw/storm,pczb/storm,srdo/storm,carl34/storm,F30/storm,cluo512/storm,adityasharad/storm,erikdw/storm,sakanaou/storm,srdo/storm,roshannaik/storm,cluo512/storm,srishtyagrawal/storm,srdo/storm,erikdw/storm,adityasharad/storm,0x726d77/storm,kishorvpatil/incubator-storm,kishorvpatil/incubator-storm,roshannaik/storm,kevinconaway/storm,kevinconaway/storm,pczb/storm,kishorvpatil/incubator-storm,kevpeek/storm,pczb/storm,pczb/storm,kevpeek/storm,adityasharad/storm,hmcc/storm,0x726d77/storm,knusbaum/incubator-storm,hmcc/storm,kamleshbhatt/storm,ujfjhz/storm,sakanaou/storm,sakanaou/storm,sakanaou/storm,adityasharad/storm,kevpeek/storm,srishtyagrawal/storm