add notes about @api.one use with the web client

@api.one will cause issues in some cases. Add notes about this in the doc.