User:Jopparn/Help guide

From translatewiki.net
Jump to: navigation, search

This is a suggested structure for the help guide. The idea is to both include the old and the new material. The nine pages will link to each other so that you can go through them one by one (I will suggest a design for this later). The plan is to have all pages set up using translation tags to make them easy to translate and to make it easy to keep all the translations synchronized. Please help by adding pages you think that they should link to/include summaries of.

  1. Translating:Introduction (about the project etc.) (this will replace Translating:Intro)
    1. Replace and include material from: Project:About
    2. See if something from here should be included: https://www.mediawiki.org/wiki/Help:Extension:Translate/Translation_example
  2. Translating:Getting started (about the first steps, account, decide what to work on,)
    1. Replace and include material from: Translating:How to start
    2. Subpage with step-by-step instructions for how to register etc. + video. (e.g. Translating:Getting started/How to)
    3. Connect to existing pages: Project:Translator, FAQ, Terminology,
    4. See if something from here should be included: https://www.mediawiki.org/wiki/Help:Extension:Translate/Translation_best_practices
  3. Translating:Joining the community (about support, project pages, language portals, discussion pages, email lists, contests etc.)
    1. Replace and include material from: Project:About
    2. Subpage with step-by-step instructions + video (e.g. Translating:Joining the community/How to)
    3. Connect to existing pages: Map of translators, Quick guide to editing translatewiki.net
  4. Translating:Translating the messages (about best translation practices, code, overview-ish)
    1. Replace and include material from: Localisation guidelines, Technology
    2. Subpage with step-by-step instructions + video (e.g. Translating:Translating the messages/How to)
    3. Connect to existing pages: Gender, Plural, Grammar, Help:Extension:Translate on Mediawiki.org, Help:Extension:Translate/Translation example on Mediawiki.org
    4. See if something from here should be included: https://www.mediawiki.org/wiki/Help:Extension:Translate/Quality_assurance
  5. Translating:Proofreading the messages (why doing it, good place to start, about what to think about when proofreading, code)
    1. Subpage with step-by-step instructions + video (e.g. Translating:Proofreading the messages/How to)
    2. Connect to existing pages: Gender, Plural, Grammar
    3. See if something from here should be included: https://www.mediawiki.org/wiki/Help:Extension:Translate/Quality_assurance
  6. Translating:Reporting a problem (covering what, why and how)
    1. Subpage with step-by-step instructions + video (e.g. Translating:Reporting a problem/How to)
    2. Connect to:
  7. Translating:Advanced (how to prepare a page for translation on translatewiki.net, how admins are chosen etc.)
    1. Subpage with step-by-step instructions (e.g. Translating:Advanced/How to)
    2. Connect to: Translating:Process, Translatewiki.net languages
  8. Translating:For developers (about what you need to think about, case study etc.)
    1. Replace and include material from: Translating:New project (possibly just a move to make it clearer what the page is about, without any major change of content), Help us
    2. Connect to: Translating:Localisation_for_developers, Technology, CLDR
  9. Translating:Helpful links (that make life easier for our volunteers, not completely sure which ones would be suitable here, this could also be in the form of a template)
    1. Connect to: Translating:Index

Instruction videos

Currently in Swedish. Subtitles could easily be added or we could send the script and some native speaker could record them in English.

Also, it seems like videos are not activated here on translatewiki.net. It would be great if someone could do that.