00:00:07This demonstration shows how callouts can
help you to quickly trace and manage changes
00:00:12or comments in a document shared between members
of a team.
00:00:16As an example, our team of three writes a
user guide for a mobile phone.
00:00:21John creates the first version of the document
and sends it out for review.
00:00:26Mary reviews the document and adds comments
and makes modifications.
00:00:33Tom does a further review of the document
and adds more comments.
00:00:39Mary receives the document again and performs
00:00:45At the end, John aggregates all the changes
and produces a final version of the document.
00:00:55John, one of the documentation authors, has
finished a draft of the "Setting Up an Email
He enables the Track Changes feature to allow
00:01:05oXygen to preserve all changes made by the
subject matter experts. Thus, he can later
00:01:10track every change made in the document.
00:01:14Mary, one of the team's Subject Matter Experts,
will now review the document draft.
00:01:23She thinks that step three of the procedure
can be split in two distinct steps.
00:01:58Notice that in its default configuration,
oXygen only displays callouts for comments,
00:02:04but in this case we also want to see callouts
for her other changes. To do this, we can
00:02:10go to the Callouts preferences page.
00:02:13You can reach this options page either from
the application's main menu or, directly from
00:02:19an action that is available in the contextual
menu of an existing callout.
00:02:26You can choose to have callouts displayed
for deletions and insertions, along with the
You can also choose to change the callouts
00:02:34rendering: display the review time and connecting
lines, or modify the initial callout width
00:02:41or the maximum number of lines displayed in
00:02:45However, to quickly adjust the width of the
callouts for the current editing session,
00:02:51you can drag the left side of any of the callouts.
00:02:54Back to reviewing... Now Mary finds that the
procedure is missing an important step, so
00:03:00she inserts a new comment.
00:03:12Mary commits the changes and now Tom, another
Subject Matter Expert, will review the document.
00:03:20Tom replies to Mary's comment and suggests
an additional step.
00:03:31Now Tom finds a mistake in the documentation
and corrects it, then he inserts a comment
00:03:40to ask his colleagues to double check this.
00:03:50Now the document comes back to Mary for further
00:03:57Mary checks Tom's comment and confirms the
button's name. She replies to Tom, then chooses
00:04:05to mark this discusion thread as being done.
Note that this part of the discussion has
00:04:13now been greyed out in order to signal that
they are not expecting someone else to add
00:04:18more comments to this thread.
00:04:21Now the review process has ended and the document
comes back to John for further editing.
00:04:30John disables the Track Changes feature because
he needs to aggregate all modifications into
00:04:35a final version of the document.
00:04:39Note that if he would have wanted to, John
could have printed the document and all the
00:04:45comments will be included in the printed output.
00:04:52Also, Oxygen includes a Review panel that
makes it easy to work with the modifications
00:04:58in a more compact view and it offers some
additional features such as filtering or being
00:05:04able to accept or reject multiple changes
00:05:08To make more room for the Review panel, John
decides to hide the callouts.
00:05:18Now John starts modifying the content based
on his colleagues' reviews.
00:05:23He first wants to work with Tom's changes,
so he filters them to show all threads that
John addresses Tom's comment at the end of
00:05:33the topic and inserts a new step in the procedure.
00:05:42Now he can remove this thread, since he addressed
00:05:46Now he wants to see the rest of the changes
so he removes the filter.
00:05:50He decides to accept the rest of the changes,
and he can easily do this by selecting all
00:06:01What you've seen so far is the oXygen standard
support for handling callouts. If you are
00:06:06a developer, you can use the oXygen API to
extend or customize this support to match
00:06:11your particular requirements.
00:06:15And this concludes our demonstration. Thanks