Arbital mark

Marks al­low read­ers to give fast feed­back to the page au­thors, which helps the au­thors fo­cus their effort. You can think of these marks as a quick way to leave an ed­i­tor-only com­ment on a spe­cific part of a page. By de­fault, the marks are only shown to the users who cre­ated them and to the page’s au­thors.

To cre­ate a mark, high­light some text on a page, then click the plus which ap­pears on the right bor­der of the page.


Mark types

When a reader gets con­fused while read­ing a page, they can cre­ate a con­fu­sion mark. For ex­am­ple:

  • “The com­plex houses mar­ried and sin­gle sol­diers and their fam­i­lies.” (While gram­mat­i­cally cor­rect, it’s not clear how to parse that sen­tence un­til you re­al­ize “com­plex” is be­ing used as a noun and “houses” as a verb.)

  • “An ionic bond is the trans­fer of elec­trons from a metal to a non-metal in or­der for both atoms to ob­tain a full valence shell.” (What’s a valence shell?)

When a reader spots a typo, a spel­ling or a gram­mar er­ror, they can cre­ate a typo mark. For ex­am­ple:

  • “tom­mor­row” (Spel­ling er­ror. Should be “to­mor­row”.)

  • “The af­fect is in­stan­ta­neous.” (Gram­mar er­ror. Should be “The effect is in­stan­ta­neous.”)

If the reader has a ques­tion or an ob­jec­tion, they can cre­ate a query mark. <div>

Re­solv­ing a mark

There are sev­eral ways to re­solve a mark:

  1. Edit the page:

  • Edit the rele­vant part of the text to make it more clear.

  • A small change like adding a link or mov­ing some text around might work.

  • Ad­ding a re­quire­ment for the page.

  1. Sim­ply re­solve the mark if it has already been ad­dressed.

  2. Dis­miss the mark if doesn’t make sense.

If you aren’t sure what to do, just leave the mark for other au­thors to fix.