docs: add some clarifications
pflask: better options descriptions