be more accurate in credits
add some explanation to the readme