phpDocs - various updates

[ramiy]

No description provided.

[DevinWalker]

Hey @ramiy we just got some time to review this and

1. Please ensure periods are not removed.
2. We can use @Package instead of @subpackage , because it is going to deprecate soon https://phpdoc.org/docs/latest/references/phpdoc/tags/subpackage.html
3. Ensure all comments are closed properly - @ravinderk said he saw a place where the comment wasn't closed by the link he provided didn't have the line number so I can't reference it. He'll post when he comes back online.

[ramiy]

@DevinWalker We already use @Package, Do you want me to delete all the @subpackage?

[DevinWalker]

If you could swap out the usage of @subpackage to @packagethat'd be great.

[ramiy]

Replace this:

 * @package     Give
 * @subpackage  Classes/Give_Cron

with:

 * @package     Give
 * @package     Classes/Give_Cron

or:

 * @package     Classes/Give_Cron

or:

 * @package     Give_Cron

[ramiy]

By the way, WordPress core still uses @subpackage, they did not deprecated them.

[DevinWalker]

@ramiy - let's go with * @package Classes/Give_Cron