Update property and method docblocks in Theme.php.

[Levdbas]

Related:

• Breaking change to TimberTheme's uri for child themes #1313

Issue

When looking through the old issues, I found this issue which I ran into a long time ago as well. So I tried to clear up the docblocks.

Solution

The changes on rule 75 and 137 are leading in this PR. The now reflect more what to expect of the property/method.

Other changes while at it:

• The changes to rule 69, 94, 116 are to give a consistent example of theme slugs.
• 113 fixes a typo.
• 146 removes a double space and adds a capital letter.

Impact

Hopefully a better overall understanding of the Theme class.

[coveralls]

Coverage: 88.599%. Remained the same when pulling 7f30f3f on 1313-breaking-change-to-timberthemes-uri-for-child-themes into b32340d on 2.x.

[gchtr]

Thanks @Levdbas

Descriptions like these can make a big difference in understanding what a property or method should do 👍