Tricki
a repository of mathematical know-how

Commenting

We would like the Tricki to become a 'living' resource, with lots of participation from the mathematical community. This participation may come in one of several forms, including authoring articles or setting up navigation pages. Another way to contribute is by helping articles to develop by commenting on them. Something that is clear to one person may very well not be clear to another, so if you find yourself unable to understand something that is written in an article, then you should feel free to comment on it, asking for clarification. Or perhaps you may want to suggest that an article should be restructured; you can do so by adding a comment. Commenting allows you to interact with content without actually editing any articles, and is fairly unobtrusive. This page contains information on how you can go about adding comments.

Adding comments: standard and inline

The first thing to notice is that there are two kinds of comments on the Tricki: comments at the end of an article and inline comments. Comments at the end of an article will most likely be familiar to you if you have visited blog sites. To add one of these, simply scroll down to the bottom of the page, type in a subject-line for your comment, the comment itself, and click "Save". (If you are not logged in, the site may ask you to verify that you are human in order to cut down on spam submissions.) This comment will then appear at the bottom of the article.

Inline comments

While ordinary comments may be useful on occasion, we strongly encourage the use of inline comments, which are comments that will appear in the article itself. To add one of these, click on the text "Turn commenting on" in the Tricki toolbar at the bottom of the browser window. (If this text does not appear, it means that you cannot add an inline comment to the page.) When inline commenting is switched on and you move your mouse cursor over sections of the article, these sections will be highlighted, allowing you to click on them. If you click on a section, a form similar to the one at the bottom of the page will appear, allowing you to submit a comment. This comment will then be added to the article in such a way that the symbol will be displayed directly after the section on which you clicked. Clicking on this symbol will display any comments associated with the preceding section.

Inline comments are also displayed at the bottom of articles, for those users that cannot open inline comments (opening them depends on the availability of JavaScript). When displayed below the article, inline comments are clearly marked as such by the presence of a link to the place in the article at which the comment was made.

Hiding inline comment traces

If you find the inline comment symbols distracting while reading an article, you can click on the "Hide inline comment markers" link in the Tricki toolbar at the bottom of the page to hide them. Should you wish to read only the comments that were made at the bottom of the article, and not the inline ones, then you can click on the link to "Hide inline comments".