Arbital mark

Marks allow readers to give fast feedback to the page authors, which helps the authors focus their effort. You can think of these marks as a quick way to leave an editor-only comment on a specific part of a page. By default, the marks are only shown to the users who created them and to the page’s authors.

To create a mark, highlight some text on a page, then click the plus which appears on the right border of the page.


Mark types

When a reader gets confused while reading a page, they can create a confusion mark. For example:

  • “The complex houses married and single soldiers and their families.” (While grammatically correct, it’s not clear how to parse that sentence until you realize “complex” is being used as a noun and “houses” as a verb.)

  • “An ionic bond is the transfer of electrons from a metal to a non-metal in order for both atoms to obtain a full valence shell.” (What’s a valence shell?)

When a reader spots a typo, a spelling or a grammar error, they can create a typo mark. For example:

  • “tommorrow” (Spelling error. Should be “tomorrow”.)

  • “The affect is instantaneous.” (Grammar error. Should be “The effect is instantaneous.”)

If the reader has a question or an objection, they can create a query mark. <div>

Resolving a mark

There are several ways to resolve a mark:

  1. Edit the page:

  • Edit the relevant part of the text to make it more clear.

  • A small change like adding a link or moving some text around might work.

  • Adding a requirement for the page.

  1. Simply resolve the mark if it has already been addressed.

  2. Dismiss the mark if doesn’t make sense.

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