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.
%%comment: ### 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 **[3bp query]** mark. %%
Resolving a mark
There are several ways to resolve a mark:
- 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.
- Simply resolve the mark if it has already been addressed.
- 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.