async или без async?

Доброго времени суток. Нашел в документации недочет. Например на странице : https://tech.yandex.ru/share/doc/dg/add-docpage/ - указан атрибут  "async", а на следующей странице:  https://tech.yandex.ru/share/doc/dg/api-docpage/ - уже написано, что его нельзя использовать. Поэтому пожалуйста внесите ясность - нужен async или нет и +, где лучше размещать код в head или перед body?