Documentaries were once treated as cinematic spinach – films that were good for you – but now, non-fiction filmmakers have transformed a genre with great storytelling