С документацией сейчас везде целенаправленно пиздец. Не мы такие, жизнь такая. Написать, и исправить то что написал сам - не фокус.
Фокус понять ЧТО ИМЕННО написали те, кто разливал дистрибутив.
И в этом смысле, "магические комментарии в скриптах" - путь в светлое никуда.