How documentation is organized, concerning flags?

Have a look at this thread:

This was the last attempt to introduce some order and logic. Current docs state is result of it.

Of course it can be improved and any ideas or PRs with changes are welcomed.