Browsing Hungarian translation

11.

Little buttons can be included in the text.

12.

Screenshots of Mahara sections are not made inline, but receive the "figure" directive. They always have an alt tag and also a brief description which will show up below the image and is numbered in LaTeX PDF.

13.

Screenshots should have as little instructions as possible about the steps that are to be taken in them. Preferably, only the step numbers so that they can be exchanged more easily and the text of the steps is translatable because it is text and not part of the image. That could also mean that translators can translate the steps but don't immediately have to change the screenshot.

14.

Inline images that are refered to in the textsuch as |edit| should be included as shortcuts with the reference at the bottom of the page.

15.

An index entry should be created for each section.

16.

Long sections should be broken up into several pages to make the editing more manageable.

17.

reStructuredText does not have a set hierarchy of heading levels. They depend on the individual files. However, to be consistent, the following convention exists:

18.

Heading 1, e.g. 1.: ===============

19.

Heading 2, e.g. 1.1.: ---------------

20.

Heading 3, e.g. 1.1.1.: ~~~~~~~~~~~~~~~