Структура справки.

[Fernando Costa]

ужас как не удобно стало, думал привыкну - фиг

[Бармалей]

Новая справка хороша тем, что позволяет на одной странице отображать (и скрывать) ВЕСЬ список членов класса: как объявленных в самом классе, так и унаследованных от суперклассов. Причем тут же видно, от какого суперкласса что унаследовалось. Старый "разделенный" способ отображения справки не целесообразен уже из-за того, что привел бы к дублированию статей по одним и тем же свойствам и методам унаследованным от надклассов.

[iNils]

Бармалей, это далеко не так. В справке по AS2 в общей статье, где перечисляются все методы и свойства, есть также и наследуемые: "Methods inherited from class Object" и никакого дублирования, идет переход сразу к статьям надкласса.

[wvxvw]

Сообщение от iNils

Чего?

пол = опрос %)
чет я не подумал %)

[fljot]

новая справка полностью удобна. чёткая иерархия, лишними методами-свойствами сразу не грузит, но они легко доступны одним кликом. весь набор свойств-методов и примеры перед глазами, анкеры спасают конечно

[iNils]

чёткая иерархия

В чем она проявляется?

лишними методами-свойствами сразу не грузит, но они легко доступны одним кликом.

Что есть лишние методы? Если я хочу прочитать только про метод draw, то все остальные будет для меня лишними. Но при этом перед глазами, вернее слева, будет дерево с другими методами.

Нужны ли все методы в одном флаконе с полным описанием? См. выше. Если одних названий мало, можно перейти на страницу с кратким описанием всех методов и свойств. Например.

весь набор свойств-методов и примеры перед глазами

См. выше. Примеры в старой версии были тоже перед глазами.

[Psycho Tiger]

Help Flash 8 уделывает Help CS`а без б

[terbooter]

Справка как в ас2 удобнее.
Справка как в ас3 "с элементом неожиданности"
пошел читать про один метод, а обнаружил еще полезную фичу (когда здоровенная статья перескочила случайно куда-то).
Но очень не удобно искать нужный пример приходиться пролистывать все (в статье про клас может быть 3-4 примера разбросаных по всей статье, а не один, как считает MrPoma. Может он остальные ненаходит -))

[Бармалей]

В доках по АС2 есть общий практически для всех классов блок, где описываются члены, унаследованные от Object. Но в АС3 более сложная иерархия объектов. Потребовалось бы несколько таких блоков. Пример для класса mx.containers.VBox: "Methods inherited from class Object", "Methods inherited from class EventDispatcher", "Methods inherited from class DisplayObject", "Methods inherited from class InteractiveObject", "Methods inherited from class DisplayObjectContainer", "Methods inherited from class Sprite", "Methods inherited from class FlexSprite", "Methods inherited from class UIComponent", "Methods inherited from class Container", "Methods inherited from class Box". Примерно такое же количество блоков понадобилось бы для описания унаследованных свойств.

Честно говоря я считаю текущее состояние справки является необходимостью при попытке описания более сложной версии языка, чем была предыдущая. Мне кажется Адоби с этим справились. Хотя примеров использования конкретных методов и свойств хотелось бы побольше.

[iNils]

Сообщение от Бармалей

В доках по АС2 есть общий практически для всех классов блок, где описываются члены, унаследованные от Object. Но в АС3 более сложная иерархия объектов. Потребовалось бы несколько таких блоков.

Безобразие! Конечно нельзя сделать в старой версии справки таблицу и перенести туда описанием методов наследуемых свойств и методов. Это же богохульство! Надо обязательно для этого новую версия справки сделать.

Речь об идеи подачи справки: общий список или статья, а не об отдельных элементах. Добавили они тут кнопочку скрыть или не добавили. И для AS3 вполне подошла структура AS2. Сводная таблица методов/свойств + разворачиваемые таблицы наследуемых методов/свойств. Но на каждую отдельная статья.
А уж про меню я вообще молчу. Можно было сделать хождение как по алфавиту, так и по дереву наследования.