The how-to pages linked from Tasks and Tools set out the basic markup for most cases. However, there are a number of situations where the preferred markup is not clear. Before I can clarify those cases I need guidance from the translators. We can add examples to this thread until we are sufficiently clear to update the how-to pages. The first example I'd like you to consider is this section:
<example 1> Konqueror is primarily a web interface, but it can also function as a traditional file manager. If this is your preference, in System Settings, go to the Advanced tab and click on File Associations. In the list of Known Types, go to the inode/directory type. In the General tab at the right side of the window, select Konqueror in the Application Preference Order and click on the Up button until it is at the top. Click on Apply to save the changes. </example>
Please indicate how you would like this to be marked. If we can look at a few such cases we should be able to formulate useful guidance.
<example 1> Konqueror is primarily a web interface, but it can also function as a traditional file manager. If this is your preference, in, go to the tab and click on . In the list of , go to the type. In the tab at the right side of the window, select in the and click on the button until it is at the top. Click on to save the changes. </example>
Actually I would recommend a few changes to the original text:
- It is generally a bad idea to use names of GUI elements as anything other than names, så I would suggest replacing "In the list of ,..." with "In the list ...".
- I think is better than ; the latter is potentially confusing since it does not match one named GUI element.
- I think "If this is your preference go to is a simpler and better way to present a sequence of GUI actions.