Now that we have ASDoc support, FDT could help developer create the documentation by giving code hint or perhaps even an automated way of doing it. A Quick Assist could be great actually. Image putting your cursor at the delcaration of a method, hitting Quick Assist and having FDT add an ASDoc comment with:
- @param for each parameter (if they exist)
- @return (if it returns a value)
- @throws (if it throws any errors)
Besides that autocomplete for the other options is helpful as well. Please see this for more info.
Also, some developers like to have the ASDoc creating auto created for them. Consider adding an option for the to happen when a method is created.
Something else is an option to refactor or update ASDoc. For example of the method signature changes.