MovingBlocks

Add documentation to WorkstationInGameHelp module

Terasology has a WorkstationInGameHelp module that extends the help menu implemented in the InGameHelp module by showing workstation-related recipes pertaining to the item at hand. 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 WorkstationInGameHelp 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 WorkstationInGameHelp module using gradlew fetchModuleWorkstationInGameHelp, 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

Joshua Wong

Task type

  • chrome_reader_mode Documentation / Training
close

2016