Update code documentation to conform to Drupal documentation standards

There are some member variables in the test class without documentation, as well as many unnecessary @file blocks, and possibly other problems with the current code documentation. It should be fully reviewed and made to conform to https://www.drupal.org/coding-standards/docs