Public api activity [WIP]

:construction: 
`* @return string|false` without spaces? or is phpdoc clever enough?