User:Wisdurm/Sandbox: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
mNo edit summary
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:The translation template crisis}}
Inline {{User:Wisdurm/Sandbox3|Wisdurm}}
{{warning|Parts marked with {{confirm}} may contain inaccurate information, feel free to correct <b>objectively</b> wrong statements.}}
__NOTOC__
==Translation template comparison==
{| class="wikitable"
|-
! Template !! Editing !! Wiki maintenance !! Search !! Conclusion
|-
| {{tl2|Lang}}
||<!-- Editing -->
===Positives===
* Fast
* Easy
===Negatives===
* Every page requires an English "base page".
* Pages in, for example, Spanish need to link to (for example) [[Main Page:es]], instead of just [[Main Page]].
* The {{tlc|Lang}} template needs to specify the full path of all subpages.
||<!-- Maintenance -->
===Positives===
* Currently used on very many pages.
* Every page being completely handled by itself without subpages makes many things very easy.
* Separate pages for different languages allows people to fix problems for pages in a language they understand.
* Every page being categorized by it's language is helpful.
===Negatives===
* Every page needs to check whether or not other language versions of said page exist everytime it's cached, leading to slow load times. {{confirm}}
* Every single maintenance template needs to have a separate version for every single language. <br>{{Note|Templates don't NEED to be translated like this, it's just how it used to be done. So this isn't really a negative when considering using {{tlc|Lang}} in the future, it only affects templates which are currently done like this.}}
* Since suffixed pages are not considered subpages, when pages are moved <i>every single</i> translated version must be moved separately, one by one.
||<!-- Search -->
===Positives===
* Search engines correctly lead to pages in the correct languages.
===Negatives===
||<!-- Notes -->
===Positives===
* Fastest and most simple to both understand and to edit.
===Negatives===
* Translations being lumped into suffixes rather than subpages causes problems such as every single translated version separately being included in categories, and it's usage for translating templates in the past is objectively inferior compared to using {{tl2|Autolang}}.
|-
| {{tl2|Multipage}}
||<!-- Editing -->
===Positives===
* Still relatively easy to use.
===Negatives===
* Newcomers to the wiki sometimes struggle with understanding the {{tlc|Multipage}} ui buttons for editing the language subpages.
* Purging the page after every edit is annoying and slow and as such sometimes people forget to actually commit their edits to the page.
* The page preview is missing certain templates such as {{tl2|This is a}} which is always on the main page.
||<!-- Maintenance -->
===Positives===
* Currently most used translation template.
* Separate pages for different languages allows people to fix problems for pages in a language they understand.
* Every page being categorized by it's language is helpful.
===Negatives===
* The length of the base page is very short, which negatively impacts [[Special:ShortPages]].
* The base page needs to check whether or not other language versions of said page exist every time it's cached, leading to slow load times. {{confirm}}
||<!-- Search -->
===Positives===
* Every language shows up correctly on search engines.
===Negatives===
*  Search engines sometimes lead to language subpages instead of the main page which can (as with pages using the {{tl2|Software page}} template) cut out a LOT of information, as well as make the page look much worse.
||<!-- Notes -->
===Positives===
* Still very simple and links being automatically redirected to translated versions is <b>very</b> helpful, also the concept of a "base page" being the only one that shows up in categories keeps the wiki cleaner.
===Negatives===
* For some pages completely ruins the wiki for search engines, and while the idea of a non-language specific "base page" is helpful, it also has it's problems.
|-
| {{tl2|Page}}
||<!-- Editing -->
===Positives===
* Since page style is independent of text, the style of a page can be updated on the the base page so that it instantly updates for all languages.
===Negatives===
* Requires splitting the article into many parts which are segmented by string subpage templates.
* Requires editing string subpages formed by copy and pasting boilerplate text.
* Doesn't support a live preview of the page while editing.
* Incredibly slow compared to other methods.
* Quite difficult to figure out and prone to broken pages due to missing brackets or other mistakes in the template code.
||<!-- Maintenance -->
 
===Positives===
* Tracks the current translation progress of all pages on which it is used.
* Text added to the base page in one language appears untranslated in other languages, which helps translators see what needs to be translated.
* Fastest page loading time since all the translation data is stored on a single subpage.
* Minimizes the amount of pages required for translations.
===Negatives===
* While the concept of untranslated text in theory is helpful, in practice:
# People would likely simply edit existing strings since it's faster due to not necessitating copy and pasting boilerplate string templates on both the subpage and the main page, which renders the "translation helping" aspect completely redundant.
# Even if they did add a new string, it would almost certainly mean that at any moment there could be hundreds of pages in different languages which have random English text sprinkled around in them since the wiki doesn't have extremely active translators for <b>every single language</b>, which would make the wiki extremely unclean and confusing for readers.
* The edit history of every single language is combined into a single page.
* When pages are moved from either {{tlc|Lang}} or {{tlc|Multipage}}, only the edit history of a single language can be saved, and the rest of the entire history of that page is permanently erased.
* Maintenance templates either need to be on the base page or the strings subpage which means that either:
:# The maintenance templates being on the main page means that the notice either needs to be removed only after the page has been fixed in every single language or it's removed as soon as only one translation has had it fixed.
:# If the maintenance templates are on the the strings subpage, they show up in maintenance categories which is annoying since it's impossible to tell for which language the problem is without going through the page, meaning someone speaking, for example Russian, would have a hard time helping with page cleanup since it's unclear which pages marked for cleanup are actually written in their language.
||<!-- Search -->
 
===Positives===
* Search engines lead to base page. {{confirm}}
===Negatives===
* Search engines may not detect languages other than English. {{confirm}}
||<!-- Notes -->
===Positives===
* Incredibly efficient in space and speed, and as with {{tlc|Multipage}}, the concept of a "base page" has many positives.
===Negatives===
* While compressing articles to only two pages (main page and strings subpage) instead of keeping translated pages as their own separate pages, which are to be dealt with separately, is good for minimizing page creation, it also seems to only complicate almost everything from editing to maintenance, making wiki editing <b>so</b> much slower and more difficult.
|-
|}
 
== Conclusion ==
===Important notes about this wiki specifically===
* This wiki is predominantly active in English, and doesn't currently even have a single translator for all available languages, so it's impossible to expect people to constantly keep pages up to date. And as such a good translation template is one which lets pages not edited in years in some languages still remain clearly understandable for readers.
* <b>Text content is more important than styling.</b> While this wiki seems to currently have an obsession with making everything look clean (me included), the reason Valve created this site is so people with knowledge on Source can actually contribute to helping others understand the engine better. So it should be much more prioritized that documentation remains up to date and correct rather than if it looks good.
<br>
<br>
There is no perfect translation template, since trying to accomplish everything that would be wanted from them only leads to oxymorons. Every template has it's ups and downs, so the best translation template is simply the one which has the most negligible downsides.
Inline {{confirm}}
 
{{Message
| user = Wisdurm
| time = 00:00, 0 Jan 0
| 1 = Personally I feel a "perfect" translation template would be somewhere in between {{tlc|Lang}} and {{tlc|Multipage}}, somehow with the best parts of both.
}}

Latest revision as of 12:51, 23 July 2024

Inline
Inline [confirm]

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=User:Wisdurm/Sandbox&oldid=439104"