We should expand upon the "don't add translate tags" warning and explain what the
languages /
translateand
!--T:n--tags are and how they should be handled.
(It seems like it didn't like the tags so I removed the <> for convenience.)
(This is mostly a note to myself, but if someone has time to do it before me - go ahead if you want.)
For future reference, you need to use <nowiki></nowiki> tags around anything that mediawiki would see as a command.
Hm, I think I tried <pre></pre> and <nowiki></nowiki> but it still complained. Maybe I missed the latter, I'll find out when I write the text. :)
What exactly are you going to write about? We have covered it in the appropriate pages. And pages are linked, wherever appropriate. Dulpication makes it hard to maintain.
Which pages would that be, Edit Markup? I think it's very relevant on this page, since you'll see it if you edit some pages, and many contributors are probably unsure of how to handle them. The first two tags only need a short mention, but <!--T:n--> should be explained in my opinion (what to do if you add, move or remove text etc.).
The description of the task this page refers to says "Modify existing content, fix a spelling, clarify a description, add more details." Adding markup is not part of that task at all. The only markup that is relevant to this page is the warning to leave tags alone.
Please keep the tasks discrete.
It's not about adding markup, it's about how to handle the existing markup - i.e. the <!--T:n--> tags.
For most parts the contributor can just ignore them (modifying existing content), but what if he/she moves some text around or deletes some text? I also think we need to clarify what we mean by "NEVER add new translate section tags.", since some may not realize what <!--T:n--> are for and add them for the new text.
The instructions for handling markup are on the page about preparing for translation, where they belong.
@annew, the problem is a simple cut and paste to a page section can result in <translate> tags appearing in preview and incomprehensible garbled internal errors like "Unbalanced </translate> tag."
Maybe leave the general instruction, but please can those errors link to something that gives you enough info to fix the problem? (I've spent 25 bloody minutes fighting --T5-- warnings and unmatched </translate> after a 2-line edit, and I've worked with SGML/HTML/XML for 26 years.)