MovingBlocks

Add documentation to Hunger module

Terasology has a Hunger module that implements a basic hunger system, as well as different food items. However, currently most of its' classes are missing vital documentation and comments, which could hamper future contributors' efforts in extending this module. Your task is to add Javadoc documentation to all classes and interfaces in the module.

Definition of 'Done'

  • All methods in every class or interface have a Javadoc comment.
    • Complex blocks of code in the methods should have a comment explaining what they do - use your best judgment here.
  • A pull request is submitted to the Hunger module containing the aforementioned requested items. Feel free to add your GitHub nickname to the list of authors in the module.txt file!

Where to start?

  • Download a copy of the Hunger module using gradlew fetchModuleHunger, create a new branch, and start from there.
  • Check out the Javadoc comments in the src folders of the Alchemy and Potions for a rough guideline on how to write the comments.
  • An intro to Javadoc can be found on the Oracle website.

Task tags

  • documentation
  • java
  • javadoc
  • writing

Students who completed this task

Jeroen Braakman

Task type

  • chrome_reader_mode Documentation / Training
close

2016