update docs to explain tag requirements and valueerror