Only part of being a software developer or engineer is about building code. A large portion of your role is to build documentation to support your other developers and potentially external developers who use your code to use it correctly.
To assist with this task, a tool called JavaDoc allows you as a developer to create specially coded comments to hold documentation around specific methods and components of your code.