Skip to content

Add more practical examples #30

@zlovatt

Description

@zlovatt

While some developers come into this doc knowing that it's mostly an API reference, it's a little obtuse for people trying to learn scripting.

To that end, adding more real-world examples into the docs would help make this appeal to a broader audience while still maintaining its status as the go-to API ref for AE scripting.

I could see this working in one of these ways (or any mix of):

  1. A new 'examples' top-level category, broken into sub-categories with examples in each
    • "Keyframes"
      • "Adding keyframes"
      • "Setting eases"
      • "Removing keyframes [note: need to do this in reverse!]", etc
    • "Render Queue"
      • "Rendering items"
      • "Setting render templates" [because this generally sucks]
  2. Adding an "Examples" page into each existing top-level category
    • "Property"
      • "Setting position values"
      • "Adding an expression"
  3. Specifically seeding the entire site with more inline examples under each property/method

Note that route 3 here may lead the docs to become a lot messier & harder to parse, for people looking for a clean API reference doc.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions