mostly made README files clearer
minor additions