Make sure docblocks match specs

Ghost User
2018-08-28T16:38:10+02:00

Closes #675

#### Previous behaviour
Steps to reproduce:

1. Generate apidocs
2. :param in texts

#### New behaviour
Steps to validate that it works:

1. Generate apidocs
2. Correct formatting

Closes #675 (closed)

Previous behaviour

Steps to reproduce:

1. Generate apidocs

2. :param in texts

New behaviour

Steps to validate that it works:

1. Generate apidocs

2. Correct formatting