Use Hypothesis for commenting/annotating docs about docs HOT 9 CLOSED

adds these three buttons to top-right of site:

top one opens sidebar with highlights and comments. don't need account for reading comments, but do need to create one (w/ password) for submitting.

one issue is I don't think I'd want the highlighting to be on by default, and when it's not on, a user would have to go exploring to find the sidebar and know that there are comments there.

from docs.

I think highlighting is good to be on by default, why not? So that one can learn that there is some extra resource available in community contributed annotations.

from docs.

Doesn't look as clean. Could get messy/crowded if there were a lot of
highlights/comments. But could work, and could probably customize styles.

On Fri, May 27, 2016 at 4:01 PM, Mitar [email protected] wrote:

I think highlighting is good to be on by default, why not? So that one can
learn that there is some extra resource available.

—
You are receiving this because you commented.
Reply to this email directly, view it on GitHub
#38 (comment), or mute
the thread
https://github.com/notifications/unsubscribe/AAPVmL7VK8eVlkV2FhpW4uIMf9433P-Uks5qF02bgaJpZM4IokaX
.

from docs.

I think with many highlights/comments they switch to something simpler, so it does not consume so much visual attention.

cc @JakeHartnell

from docs.

But could work, and could probably customize styles.

Yes you can customize the styles and so that by default highlights are off. There is a minimalist heatmap with tabs on the side showing annotations are present. I haven't worked there for a while so don't know what the latest plans / customization options are. cc @judell @dwhly @robertknight

from docs.

I think with many highlights/comments they switch to something simpler, so it does not consume so much visual attention

Currently we do not change strategy when there are more or less highlights.

Here are some config params for the sidebar, such as disabling highlights by default:
https://hypothes.is/for-publishers/

from docs.

Extreme example:

https://hypothes.is/welcome

I guess I do like Medium highlighting

from docs.

See also https://forums.meteor.com/t/annotated-guide/25749

from docs.

I'm closing this issue because it's too old.

If you think this issue is still relevant please open a new one.

from docs.