improve clarity of description of feature flags and update feature flag list

[sdondley]

I found the description of feature flags to be confusing so I rewrote it to provide more clarity. I updated the feature flag table and examples as well.

[ehuelsmann]

Thanks for your contribution! Merged (which means it'll be published in a few seconds).