Document what "boolean" means for BROKEN/ESSENTIAL; Some reformatting

As mentioned on irc.