Tweak some admoniitions

zlovatt · zlovatt · commit 8a2c7700c4ae · 2025-01-24T20:50:52.000-05:00
diff --git a/docs/index.md b/docs/index.md
@@ -17,6 +17,8 @@ If you're not sure where to start, take a look at the [Overview](./introduction/
 
 This endeavour is primarily community-supported & run; contributors are welcome and encouraged to suggest fixes, adjustments, notes/warnings, and anything else that may help the project.
 
+For specific information on how to contribute & best practices, see the [Documentation Contribution Guide](https://docsforadobe.dev/contributing/contribution-guide/).
+
 ## Licensing & Ownership
 
 This project exists for educational purposes only.
diff --git a/docs/item/avitem.md b/docs/item/avitem.md
@@ -6,9 +6,11 @@
 
 The AVItem object provides access to attributes and methods of audio/visual files imported into After Effects.
 
-> AVItem is a subclass of Item. All methods and attributes of Item, in addition to those listed below, are available when working with AVItem. See [Item object](item.md)
+!!! info
+    AVItem is a subclass of Item. All methods and attributes of Item, in addition to those listed below, are available when working with AVItem. See [Item object](item.md)
 
-> AVItem is the base class for both CompItem and FootageItem, so AVItem attributes and methods are also available when working with CompItem and FootageItem objects. See [CompItem object](compitem.md) and [FootageItem object](footageitem.md).
+!!! info
+    AVItem is the base class for both CompItem and FootageItem, so AVItem attributes and methods are also available when working with CompItem and FootageItem objects. See [CompItem object](compitem.md) and [FootageItem object](footageitem.md).
 
 !!! warning
     CompItems and FootageItems, while logical descendants of AVItem, are not *really* subclasses of AVItem as AVItem doesn't exist in Extendscript, ie. attempting to check if `item instanceof AVItem` will fail because AVItem is undefined. This is also true for `Item` itself.
diff --git a/docs/item/compitem.md b/docs/item/compitem.md
@@ -9,7 +9,8 @@
 
 The CompItem object represents a composition, and allows you to manipulate and get information about it. Access the objects by position index number in a project's item collection.
 
-> CompItem is a subclass of [AVItem object](avitem.md), which is a subclass of [Item object](item.md). All methods and attributes of AVItem and Item, in addition to those listed below, are available when working with CompItem.
+!!! info
+    CompItem is a subclass of [AVItem object](avitem.md), which is a subclass of [Item object](item.md). All methods and attributes of AVItem and Item, in addition to those listed below, are available when working with CompItem.
 
 #### Example
 
diff --git a/docs/item/footageitem.md b/docs/item/footageitem.md
@@ -7,7 +7,8 @@
 
 The FootageItem object represents a footage item imported into a project, which appears in the Project panel. These are accessed by position index number in a project's item collection.
 
-> FootageItem is a subclass of [AVItem object](avitem.md), which is a subclass of [Item object](item.md). All methods and attributes of AVItem and Item, in addition to those listed below, are available when working with FootageItem.
+!!! info
+    FootageItem is a subclass of [AVItem object](avitem.md), which is a subclass of [Item object](item.md). All methods and attributes of AVItem and Item, in addition to those listed below, are available when working with FootageItem.
 
 ---
 
diff --git a/docs/item/item.md b/docs/item/item.md
@@ -9,7 +9,8 @@
 
 The Item object represents an item that can appear in the Project panel. The first item is at index 1.
 
-> Item is the base class for [AVItem object](avitem.md) and for [FolderItem object](folderitem.md), which are in turn the base classes for various other item types, so Item attributes and methods are available when working with all of these item types.
+!!! info
+    Item is the base class for [AVItem object](avitem.md) and for [FolderItem object](folderitem.md), which are in turn the base classes for various other item types, so Item attributes and methods are available when working with all of these item types.
 
 #### Example
 
diff --git a/docs/item/itemcollection.md b/docs/item/itemcollection.md
@@ -6,7 +6,8 @@
 
 The ItemCollection object represents a collection of items. The ItemCollection belonging to a Project object contains all the Item objects for items in the project. The ItemCollection belonging to a FolderItem object contains all the Item objects for items in that folder.
 
-> ItemCollection is a subclass of [Collection object](../other/collection.md). All methods and attributes of Collection, in addition to those listed below, are available when working with ItemCollection.
+!!! info
+    ItemCollection is a subclass of [Collection object](../other/collection.md). All methods and attributes of Collection, in addition to those listed below, are available when working with ItemCollection.
 
 ---
 
diff --git a/docs/layer/avlayer.md b/docs/layer/avlayer.md
@@ -6,9 +6,11 @@
 
 The AVLayer object provides an interface to those layers that contain AVItem objects (composition layers, footage layers, solid layers, text layers, and sound layers).
 
-> AVLayer is a subclass of [Layer object](layer.md). All methods and attributes of Layer, in addition to those listed below, are available when working with AVLayer.
+!!! info
+    AVLayer is a subclass of [Layer object](layer.md). All methods and attributes of Layer, in addition to those listed below, are available when working with AVLayer.
 
-> AVLayer is a base class for [TextLayer object](textlayer.md), so AVLayer attributes and methods are available when working with TextLayer objects.
+!!! info
+    AVLayer is a base class for [TextLayer object](textlayer.md), so AVLayer attributes and methods are available when working with TextLayer objects.
 
 #### AE Properties
 
diff --git a/docs/layer/cameralayer.md b/docs/layer/cameralayer.md
@@ -6,7 +6,8 @@
 
 The CameraLayer object represents a camera layer within a composition. Create it using [LayerCollection.addCamera()](layercollection.md#layercollectionaddcamera). It can be accessed in an item's layer collection either by index number or by a name string.
 
-> CameraLayer is a subclass of [Layer object](layer.md). All methods and attributes of Layer are available when working with CameraLayer.
+!!! info
+    CameraLayer is a subclass of [Layer object](layer.md). All methods and attributes of Layer are available when working with CameraLayer.
 
 #### AE Properties
 
diff --git a/docs/layer/layer.md b/docs/layer/layer.md
@@ -6,9 +6,11 @@
 
 The Layer object provides access to layers within compositions. It can be accessed from an item's layer collection either by index number or by a name string.
 
-> Layer is a subclass of [PropertyGroup](../property/propertygroup.md), which is a subclass of [PropertyBase](../property/propertybase.md). All methods and attributes of PropertyGroup, in addition to those listed below, are available when working with Layer, with the exception that `propertyIndex` attribute is set to `undefined`.
+!!! info
+    Layer is a subclass of [PropertyGroup](../property/propertygroup.md), which is a subclass of [PropertyBase](../property/propertybase.md). All methods and attributes of PropertyGroup, in addition to those listed below, are available when working with Layer, with the exception that `propertyIndex` attribute is set to `undefined`.
 
-> Layer is the base class for [CameraLayer object](cameralayer.md), [LightLayer object](lightlayer.md), and [AVLayer object](avlayer.md), so Layer attributes and methods are available when working with all layer types. Layers contain AE properties, in addition to their JavaScript attributes and methods. For examples of how to access properties in layers, see [PropertyBase object](../property/propertybase.md).
+!!! info
+    Layer is the base class for [CameraLayer object](cameralayer.md), [LightLayer object](lightlayer.md), and [AVLayer object](avlayer.md), so Layer attributes and methods are available when working with all layer types. Layers contain AE properties, in addition to their JavaScript attributes and methods. For examples of how to access properties in layers, see [PropertyBase object](../property/propertybase.md).
 
 #### Example
 
diff --git a/docs/layer/layercollection.md b/docs/layer/layercollection.md
@@ -6,7 +6,8 @@
 
 The LayerCollection object represents a set of layers. The LayerCollection belonging to a [CompItem object](../item/compitem.md) contains all the layer objects for layers in the composition. The methods of the collection object allow you to manipulate the layer list.
 
-> LayerCollection is a subclass of [Collection object](../other/collection.md). All methods and attributes of Collection, in addition to those listed below, are available when working with LayerCollection.
+!!! info
+    LayerCollection is a subclass of [Collection object](../other/collection.md). All methods and attributes of Collection, in addition to those listed below, are available when working with LayerCollection.
 
 #### Example
 
diff --git a/docs/layer/lightlayer.md b/docs/layer/lightlayer.md
@@ -6,7 +6,8 @@
 
 The LightLayer object represents a light layer within a composition. Create it using the [LayerCollection.addLight()](layercollection.md#layercollectionaddlight) method. It can be accessed in an item's layer collection either by index number or by a name string.
 
-> LightLayer is a subclass of [Layer object](layer.md). All methods and attributes of Layer are available when working with Light-Layer.
+!!! info
+    LightLayer is a subclass of [Layer object](layer.md). All methods and attributes of Layer are available when working with Light-Layer.
 
 #### AE Properties
 
diff --git a/docs/layer/shapelayer.md b/docs/layer/shapelayer.md
@@ -6,4 +6,5 @@
 
 The ShapeLayer object represents a shape layer within a composition. Create it using [LayerCollection.addShape()](layercollection.md#layercollectionaddshape). It can be accessed in an item's layer collection either by index number or by a name string.
 
-> ShapeLayer is a subclass of [AVLayer](avlayer.md), which is a subclass of [Layer](layer.md). All methods and attributes of AVLayer and Layer are available when working with ShapeLayer.
+!!! info
+    ShapeLayer is a subclass of [AVLayer](avlayer.md), which is a subclass of [Layer](layer.md). All methods and attributes of AVLayer and Layer are available when working with ShapeLayer.
diff --git a/docs/layer/textlayer.md b/docs/layer/textlayer.md
@@ -6,7 +6,8 @@
 
 The TextLayer object represents a text layer within a composition. Create it using the [LayerCollection object's addText method](layercollection.md#layercollectionaddtext). It can be accessed in an item's layer collection either by index number or by a name string.
 
-> TextLayer is a subclass of [AVLayer](avlayer.md), which is a subclass of [Layer](layer.md). All methods and attributes of AVLayer and Layer are available when working with TextLayer.
+!!! info
+    TextLayer is a subclass of [AVLayer](avlayer.md), which is a subclass of [Layer](layer.md). All methods and attributes of AVLayer and Layer are available when working with TextLayer.
 
 #### AE Properties
 
diff --git a/docs/layer/threedmodellayer.md b/docs/layer/threedmodellayer.md
@@ -9,7 +9,8 @@
 
 The ThreeDModelLayer object represents a 3D Model layer within a composition.
 
-ThreeDModelLayer is a subclass of [AVLayer object](avlayer.md). All methods and attributes of AVLayer are available when working with ThreeDModelLayer.
+!!! info
+    ThreeDModelLayer is a subclass of [AVLayer object](avlayer.md). All methods and attributes of AVLayer are available when working with ThreeDModelLayer.
 
 #### AE Properties
 
diff --git a/docs/property/maskpropertygroup.md b/docs/property/maskpropertygroup.md
@@ -6,7 +6,8 @@
 
 The MaskPropertyGroup object encapsulates mask attributes in a layer.
 
-> MaskPropertyGroup is a subclass of [PropertyGroup object](propertygroup.md). All methods and attributes of [PropertyBase object](propertybase.md) and PropertyGroup, in addition to those listed below, are available when working with MaskPropertyGroup.
+!!! info
+    MaskPropertyGroup is a subclass of [PropertyGroup object](propertygroup.md). All methods and attributes of [PropertyBase object](propertybase.md) and PropertyGroup, in addition to those listed below, are available when working with MaskPropertyGroup.
 
 ---
 
diff --git a/docs/property/property.md b/docs/property/property.md
@@ -6,7 +6,8 @@
 
 The Property object contains value, keyframe, and expression information about a particular AE property of a layer. An AE property is a value, often animatable, of an effect, mask, or transform within an individual layer. For examples of how to access properties, see [PropertyBase object](propertybase.md) and [PropertyGroup.property()](propertygroup.md#propertygroupproperty).
 
-> Property is a subclass of [PropertyBase](propertybase.md). All methods and attributes of PropertyBase, in addition to those listed below, are available when working with Property.
+!!! info
+    Property is a subclass of [PropertyBase](propertybase.md). All methods and attributes of PropertyBase, in addition to those listed below, are available when working with Property.
 
 !!! note
     JavaScript objects commonly referred to as "properties" are called "attributes" in this guide, to avoid confusion with the After Effects definition of property.
diff --git a/docs/property/propertybase.md b/docs/property/propertybase.md
@@ -15,7 +15,8 @@ var effect1againtoo2 = app.project.item(1).layer(1)("Effects")("Add Grain")("Vie
 
 See also [PropertyGroup.property()](propertygroup.md#propertygroupproperty).
 
-> PropertyBase is the base class for both [Property](property.md) and [PropertyGroup](propertygroup.md), so PropertyBase attributes and methods are available when working with properties and property groups.
+!!! info
+    PropertyBase is the base class for both [Property](property.md) and [PropertyGroup](propertygroup.md), so PropertyBase attributes and methods are available when working with properties and property groups.
 
 #### Reference invalidation
 
diff --git a/docs/property/propertygroup.md b/docs/property/propertygroup.md
@@ -6,9 +6,11 @@
 
 The PropertyGroup object represents a group of properties. It can contain Property objects and other PropertyGroup objects. Property groups can be nested to provide a parent-child hierarchy, with a Layer object at the top (root) down to a single Property object, such as the mask feather of the third mask. To traverse the group hierarchy, use PropertyBase methods and attributes; see [PropertyBase.propertyGroup()](propertybase.md#propertybasepropertygroup). For examples of how to access properties and property groups, see [PropertyBase object](propertybase.md).
 
-> PropertyGroup is a subclass of [PropertyBase](propertybase.md). All methods and attributes of PropertyBase, in addition to those listed below, are available when working with PropertyGroup.
+!!! info
+    PropertyGroup is a subclass of [PropertyBase](propertybase.md). All methods and attributes of PropertyBase, in addition to those listed below, are available when working with PropertyGroup.
 
-> PropertyGroup is a base class for [Layer](../layer/layer.md) and [MaskPropertyGroup](maskpropertygroup.md). PropertyGroup attributes and methods are available when working with layer or mask groups.
+!!! info
+    PropertyGroup is a base class for [Layer](../layer/layer.md) and [MaskPropertyGroup](maskpropertygroup.md). PropertyGroup attributes and methods are available when working with layer or mask groups.
 
 ---
 
diff --git a/docs/renderqueue/omcollection.md b/docs/renderqueue/omcollection.md
@@ -6,7 +6,8 @@
 
 The OMCollection contains all of the output modules in a render queue. The collection provides access to the [OutputModule objects](outputmodule.md), and allows you to create them. The first OutputModule object in the collection is at index position 1.
 
-> OMCollection is a subclass of [Collection object](../other/collection.md). All methods and attributes of Collection are available when working with OMCollection.
+!!! info
+    OMCollection is a subclass of [Collection object](../other/collection.md). All methods and attributes of Collection are available when working with OMCollection.
 
 ---
 
diff --git a/docs/renderqueue/rqitemcollection.md b/docs/renderqueue/rqitemcollection.md
@@ -6,7 +6,8 @@
 
 The RQItemCollection contains all of the render-queue items in a project, as shown in the Render Queue panel of the project. The collection provides access to the [RenderQueueItem objects](renderqueueitem.md), and allows you to create them from compositions. The first RenderQueueItem object in the collection is at index position 1.
 
-> RQItemCollection is a subclass of [Collection object](../other/collection.md). All methods and attributes of Collection are available when working with RQItemCollection.
+!!! info
+    RQItemCollection is a subclass of [Collection object](../other/collection.md). All methods and attributes of Collection are available when working with RQItemCollection.
 
 ---
 
diff --git a/docs/sources/filesource.md b/docs/sources/filesource.md
@@ -9,7 +9,8 @@
 
 The FileSource object describes footage that comes from a file.
 
-> FileSource is a subclass of [FootageSource object](footagesource.md). All methods and attributes of FootageSource, in addition to those listed below, are available when working with FileSource.
+!!! info
+    FileSource is a subclass of [FootageSource object](footagesource.md). All methods and attributes of FootageSource, in addition to those listed below, are available when working with FileSource.
 
 ---
 
diff --git a/docs/sources/footagesource.md b/docs/sources/footagesource.md
@@ -9,7 +9,8 @@
 
 The FootageSource object holds information describing the source of some footage. It is used as the `mainSource` of a [FootageItem object](../item/footageitem.md), or the `proxySource` of a [CompItem object](../item/compitem.md) or FootageItem.
 
-> FootageSource is the base class for [SolidSource object](solidsource.md), so FootageSource attributes and methods are available when working with SolidSource objects.
+!!! info
+    FootageSource is the base class for [SolidSource object](solidsource.md), so FootageSource attributes and methods are available when working with SolidSource objects.
 
 ---
 
diff --git a/docs/sources/placeholdersource.md b/docs/sources/placeholdersource.md
@@ -9,4 +9,5 @@
 
 The PlaceholderSource object describes the footage source of a placeholder.
 
-> PlaceholderSource is a subclass of [FootageSource object](footagesource.md). All methods and attributes of FootageSource are available when working with PlaceholderSource. PlaceholderSource does not define any additional methods or attributes.
+!!! info
+    PlaceholderSource is a subclass of [FootageSource object](footagesource.md). All methods and attributes of FootageSource are available when working with PlaceholderSource. PlaceholderSource does not define any additional methods or attributes.
diff --git a/docs/sources/solidsource.md b/docs/sources/solidsource.md
@@ -9,7 +9,8 @@
 
 The SolidSource object represents a solid-color footage source.
 
-> SolidSource is a subclass of [FootageSource](footagesource.md). All methods and attributes of FootageSource, in addition to those listed below, are available when working with SolidSource.
+!!! info
+    SolidSource is a subclass of [FootageSource](footagesource.md). All methods and attributes of FootageSource, in addition to those listed below, are available when working with SolidSource.
 
 ---
 
