[scripts/generate] clear out files from previous runs before generating
[docs] [api] updated to match spec