Skip to content

Commit

Permalink
Polishing version guidelines
Browse files Browse the repository at this point in the history
  • Loading branch information
b-wils committed Jul 19, 2024
1 parent 48cb27f commit 7654421
Showing 1 changed file with 10 additions and 14 deletions.
24 changes: 10 additions & 14 deletions docs/specs/composition.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,29 +13,25 @@ guidelines:

* Major version updates MAY contain breaking changes that are not compatible
with previous versions of the specification.
* Minor version updates are typically adding new functionality and SHOULD NOT
* Minor version updates typically add new functionality and SHOULD NOT
contain breaking changes.
* Patch version updates are typically making minor changes to already existing
* Patch version updates typically make minor changes to already existing
functionality.

#### Authoring Tools

Authoring tools SHOULD specify the latest version of the Lottie Specification.
They MAY want to allow the targeted major version to be configurable to
facilitate playback on a wide range of players. Changing the targeted major
version MAY also require changes to the animation for any breaking changes
between versions.

Authoring tools SHOULD always use the latest minor/patch version for the
targeted major version(s) as these are backwards compatible, even if the
authoring tool doesn't support any of the newer functionality.
They MAY allow the major version to be configurable to facilitate playback on a
wider range of players. Changing the targeted major version MAY also require
changes to the produced animation in the case of any breaking changes between
major versions.

#### Animation Players

Players SHOULD determine what major versions they support and also any
conditional logic to handle brekaing changes across major versions as needed.
Players SHOULD expect to handle animations that specify both newer and older
versions of the Lottie specification and SHOULD issue a warning if:
Players SHOULD determine what major versions they support and handle brekaing
changes across supported major versions. Players SHOULD expect to handle
animations that specify both newer and older versions of the Lottie
specification and SHOULD issue a warning if:

* The animation specifies a major version that is not supported.
* The animation specifies a newer minor version.
Expand Down

0 comments on commit 7654421

Please sign in to comment.