Netbeans in a great environment, but in order to use all its power (completion/find usage/...), phpdoc needs to be written in a specific way:

/* @var $media Book */

/**

• @property Book $media
• @return Book
  */

How to complete this issue:
1. identify all phpdoc annotations specific to Netbeans (read Netbeans docs)
2. write a documentation in the Moodledocs how to write proper and compatible code with Netbeans
3. add missing phpdoc to Moodle core