Translating talk:Index/LiquidThreads

This page contains archived discussions using the Liquid Threads extension. You can still participate in existing conversations, but you should start new conversations using the new discussion tools on the main talk page.

CLOSED This issue is closed by Nemo_bis

Perhaps "replaced" by Support/Documentation review.

We have added a few new pages to help beginners. To that we suggest that Translating:Getting_started is merged with Translating:How to start and that Project:About is moved to Translating:Introduction to translatewiki.net for consistency. Please check out the pages linked from Template:BeginnerInstructions to see if they make sense and are coherent and understandable.

Done. Is what said at Thread:Support/Help Guide still valid?

CLOSED This issue is closed

Continues at the new thread

Hi everybody,

I've been thinking a bit about how to make our instruction pages easier to find and use. I have seen a need for this when I have been organizing translate-a-thons for new users (as part of my work at Wikimedia Sverige). A draft is started on User:Jopparn/Help guide and I would love comments and ideas. Next week me and my colleague will start writing on the text (the plan is that we start at number 1 and work our down the list).

We have also been working on a number of videos that we would like to include there as soon as subtitles are added (and videos are activated here).

I hope you think that this sounds good. Let me know either way :-)

Cheers,

Thanks for working on this

How does this connect to the previous Support/Documentation review?

It's not clear to me what you are proposing to do. It's certainly not a good idea to create more pages, while it's good to consolidate existing ones. Generic information (not specific to translatewiki.net) should be on mediawiki.org and not be replicated here. Video are very nice; TimedMediaHandler however still refuses to work with Translate (i.e. to use language-code subpages), will you also be able to fix that bug?

Something I identified earlier as regards Translate's documentation is that mw:Help:Extension:Translate lists help pages by kind of action, while often we need a list/walkthrough by persona/role. "Just" presenting the information better would do a lot.

Hi!

Thank you for your questions, and sorry for the late reply! I had a bunch of hard deadlines these last two weeks.

The idea with the document review was to get an overview to see what has been done before and what is still missing. Now when we have the pages structured it's easy to get an overview and figure out how we can now connect them better and consolidate existing ones in a more structured way, and by doing so reduce redundancy and improve clarity.

The help pages will be a good entry point for beginners so that they, step-by-step, can understand the platform and how to contribute. They will mostly connect existing material with short summaries (as is done on Wikipedia's instruction pages). The summaries will make it easier to find the material that exists here or on other wikis (as they will include the keywords that people will search for). When I have organized events to teach newbies on other wikis the value of worked through help pages has been very clear. (The main audience is the translators and not the developers.)

I think that the easiest is to discuss further when we have some concrete examples ready. Hopefully I will have something ready to show you all next week.

Kind regards,

CLOSED This issue is closed by Lokal Profil

Status is tracked on the wiki page

In one of Wikimedia Sverige's (WMSE) projects we are looking at increasing the participation in, and use of, translatewiki.net. As part of that we are looking closer at the documentation available on translatewiki and how it can be improved.

As a first step we have now initiated a review of the existing documentation pages which is available at Support/Documentation review. Anyone wanting to work on this area of translatewiki is invited to take a look and participate in the process.

We have one review page too, http://etherpad.wikimedia.org/translate-doc

To give some context for above, we did that couple of years ago for Translate extension documentation. We moved that to mediawiki.org, expanded it and made it translatable. We did not ever get into doing a similar kind of exercise for translatewiki.net docs.

translatewiki.net docs were also examined in that pad. They were abruptly removed at some point, but saved versions contain the required info

Hi Lokal Profil, I updated the page. I pruned or merged some pages. I split the list in three. IMHO,

• there is only about a dozen pages to focus on: they mostly already have all the needed content (the really necessary information is on mediawiki.org help), but they need to be connected better;
• all the other pages are not worth working on for you, the goal is to ensure they are not in the way (a better separation of namespaces may help, as well as a review of incoming links).

Is there a reason, why this page is not translated to other languages?

Yes, the reason is that translating links is generally not that useful and that we've not yet assessed thoroughly what documentation pages should be maintained here and what not. etherpad.wikimedia.org/translate-doc has a list of what we want to check (in the history; see links at the bottom).