The README should contain the following elements - The title of the project - A brief decription of what the project shows - A visual of the running project. This may be either a static image or a gif ([ScreenToGif](https://www.screentogif.com/) may be helpful) - When possible a brief explanation of how the code works. You can see an example [here](https://github.com/Keboo/MaterialDesignInXaml.Examples/blob/master/Animation/WelcomeMessage/README.md)