update code documentation for PSR-5 and WordPress PHP documentation standards
Merge pull request #489 from niallkennedy/docs-cleanup

update code documentation for PSR-5 and WordPress PHP standards