[api][flags] Started working on the `Parser#flag` specification #3
[doc] Updated the documentation