[api] Mention 12 character limit on variable names

Figured this out the hard way. I don't expect the limit to change, so might as well update the docs so others don't spend a lot of time wondering where their variable went.