Sylvia/docs/doc 1062

@mhoeber @lamagnifica @catong Please review. I feel like the tone for the intro is pretty good but I'm not sure if I need to include more information. What do you think?