Code review comment for lp:~zyga/checkbox/fix-1328903

We need to document the new flags: field, and document possible values since this is handled magically in the code; otherwise this risks becoming an arcane feature nobody will be able to use (like environ: which is rather obscure).

But code-wise, this is OK, so let's go ahead.