18 Jan
2010
18 Jan
'10
5:51 p.m.
Hi,
Thanks for all your feedback.
----A----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
* there should be a way to completely hide the annotations:
the note icons & the annotations bar.
* also, completely hide should include the blue bar or filtering panel or
I disagree here: Highlight and Icon offers different types of information.
They should be represented separately.
- Highlight is used to show the limits of an annotation (start, end);
- Highlight is used to visually represent by color the author of the
annotation (or any other metadata);
- Highlight always present in the text can disturb the user from scanning
the text, because colors can be very distracting.
- Icon is used to show the presence of an annotation at a given location;
- Icon is used to visually represent the type of the annotation (valid,
modified, dangling);
- Icon is less disturbing and can be easily skipped when scanning text;
---C-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
What is the event that triggers the annotation details/actions overlay:
<highlight><body of annotation></highlight><icon/
Normal display: <body of the annotation></icon
Hover:
-- body of the annotation: nothing happens. User can select the text,
copy paste it and react with it in the normal mode.
-- icon: show the highlight - this way you can see the limits of the
annotation. The action is obvious since you're hovering a foreign object of
the text.
Click:
-- body of the annotation: browser native behavior (selects a word, a
line);
-- icon: display annotation details/actions overlay.
When we have the highlight present (with or without the icon) the
details/actions overlay needs to appear on click.
---D-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
* in the annotations tab, the order of the info should be: selected text and
> annotation metadata (comment) rather than the other way around, because
> usually
> the metadata refers the text and it's more natural for the user to know the
> annotated text when it reads the metadata. However that whole tab should be
> customizable for extra metadata so that's not that important
When I divided the annotations in two parts (contextual actions + tab) the
rationale was like this:
- contextual actions were for browsing: text is king, annotations are
helpful for the text;
- tab: annotations are important, this way you can scan them easily without
the need to click for each one.
That's why I put the importance on the annotation and not on the annotated
text.
---Thibaut---------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Thank you so much for your feedback and for your SVG (I've reused it for the
last mockup). The HTML+CSS for the first mockup were at
http://incubator.myxwiki.org/xwiki/bin/view/Improvements/Annotations
- your display options are not very well positioned because the example is a
poem, but in real life, the text will use all the area, and the right
aligned position will not look so smooth as it looks now, being pushed up
and outside the text.
- your ideas and scenario about the similarities between annotations and
comment is interesting and pertinent. Anca should tell her opinion about
this from an implementation point of view.
- if the annotations were comments, then we don't need a separation of
terms. The icon should be comment instead of annotation and they should
suppose to be localized comments, not something else. And also we didn't
need two add actions in the tab.
- I disagree with the explicit display of replies in the annotation
details/actions overlay. This representation could get very big and block
all the text behind. Also if we would display it like this, then the Tab
would be redundant.
- I agree with the icon from the tab that takes you to the location in the
content.
- The problem with this approach is that we need to annotate not just text,
but add tags and other metadata to the content. This is an argument to have
another tab for annotations.
- when you show linked replies for an annotation, the new comment you add is
an annotation for the original annotation? or for the comment? :)
Thank you again for your comments. Was great to see another approach for the
annotations.
Caty
anything is there
* there should be a link from the top of the document to the annotations
tab, as
for the other tabs (comments, attachments, etc), or any other way of
accessing
it from the annotations context
Please take a look at:
http://incubator.myxwiki.org/xwiki/bin/download/Improvements/AnnotationsPro…
- Annotations is integrated as a toggle (just like Watch). Clicking on it
reveals the annotations options:
-- filtering (show / hide all annotations + annotator highlighting ),
-- icon display (show / hide annotation icons + icon's legend),
-- add help (+/- Add link + how to add annotation help).
- This way you can view the page in the normal manner, without any
enhancements.
---B-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Otherwise put, highlight & icon should go together.
