API guidelines: revises warning about +...+ [ci skip]

Modern RDoc accepts a few more things in +...+. In particular symbols work now.

The current regexp in RDoc is https://github.com/rdoc/rdoc/blob/v4.1.1/lib/rdoc/markup/attribute_manager.rb#L133.
adds a section about booleans in the API guidelines [ci skip]