diff --git a/docs/libs/architecture.xml b/docs/libs/architecture.xml
index 0465b5571f..f42f209af8 100644
--- a/docs/libs/architecture.xml
+++ b/docs/libs/architecture.xml
@@ -66,20 +66,28 @@
The GESTimeline is a
GstElement. It can therefore be used in any
GStreamer pipeline like any other object.
+
+
+
+
+ Tracks and LayersThe GESTimeline can contain two types of objects (seen in ):
- Layers - Corresponds to the user-visible layout of
- non-overlapping objects. A minimalistic timeline would only have
- one layer. A more complex editing application could use as many as
- needed.
+ Layers - Corresponds to the user-visible arrangement of clips,
+ and what you primarily interact with as an application developer.
+ A minimalistic timeline would only have one layer,
+ but a more complex editing application could use as many as needed.
+
- Tracks - Corresponds to the output stream formats. A typical
- GESTimeline would have a audio track and a video track. An audio
- editor would only require one single audio Track.
+ Tracks - Corresponds to the output streams in GStreamer.
+ A typical GESTimeline, aimed at a video editing application, would
+ have an audio track and a video track.
+ A GESTimeline for an audio editing application would only require
+ an audio track. Multiple layers can be related to each track.
@@ -94,22 +102,10 @@
In order to reduce even more the amount of GStreamer interaction
- the application developer has to deal with , a convenience GstPipeline
+ the application developer has to deal with, a convenience GstPipeline
has been made available specifically for Timelines : GESTimelinePipeline.
-
- Timeline layers
-
- The layers are the end-user visible part of GES.
-
-
-
- Timeline Tracks
-
- The tracks are the GStreamer-level components of a Timeline. They
- are a 1-to-1 relationship to the output streams.
-