I see a few of `@param int` in the code.
Even though our convention says `boolean|integer`, the short form `bool|int` could also make a lot of sense as it doesnt't take up as much space and would be in sync with the casting convention.
I could unify it to the short syntax for master and update the book/standards if that is the convention we want to settle on.