MovingBlocks

Update or add a readme to an existing module

The readme provides an introduction to a module. Some of the module readme's haven't been updated in a while. A good readme should provide a strong introduction to someone working or using the module.

A readme is the first thing people see when looking at the module on Github. As such it should provide a quick overview of what the module is. It should list some of the features of the module and point to where more information can be found (If there is any). It's a file named readme.md in the top folder of the repository (next to the module.txt file)

Definition of 'Done'

  • A pull request to the an existing module with a readme that could work with a tweak or an update. This should be at least a few sentences or better yet several sections, but naturally some modules have more to talk about than others
    • Try and include at least one image in the readme.

Where to start

  • If possibly try to play the game with the content from the specific module to understand it better
  • Look at some example readme in Teraasology Repos

Task tags

  • readme
  • terasology
  • markdown
  • module

Students who completed this task

Jindřich Dítě, Rajat Patel, Sagar Gupta, Max Borsch, eviltak, Chaitanya, Aleksander Wójtowicz, Alberto, Nicholas Bates, Thomas O'Keeffe

Task type

  • chrome_reader_mode Documentation / Training
  • assessment Outreach / Research
  • done_all Quality Assurance
close

2017