Примерно с месяц назад общался с одним практикующим PHP-программистом, который очень нелестно отзывался о документации, поставляющейся вместе с Java Development Kit. Он говорил, что в PHP с этим дела обстоят гораздо лучше. Мол там все круто, подробно и на русском. Однако этот человек был впечатлен, когда я ему показал какая документация по классам Flex 2 выложена на ливдоках Adobe. Не знаю уж, что его впечатлило — видимо оценка о качестве документации выставлялась исходя из ее внешнего вида. Ладно, оставим этого человека в покое и перейдем непосредственно к сегодняшней новости.
Если вы владеете клавишей F1, то вы наверняка знаете, что точно такая же документация, как и на ливдоках, входит в состав справки к Flex Builder и Flash CS 3. Более того, вы можете самостоятельно создавать подобную документацию к своим проектам — это делается очень просто при помощи утилиты ASDoc, которая входит в состав Flex SDK. О том как ей пользоваться видимо будет рассказано позже. А вот о том, как правильно документировать исходный ActionScript код, чтобы потом можно было создавать красоту, удивляющую даже похапэшников, читайте статью «Вся правда о ASDoc комментариях. Часть первая», которую выложил Гена «SHAGGYSMILE» Уханов в своем блоге.
