Multilingual tour for interface translation section

assigning to myself per Kristen Pol

I am postponing work on this as their seems to be a bug in the new token patch - https://drupal.org/node/2019469#comment-7544517

The User interface translation page located at admin/config/regional/translate is useless until you add a language and I think their really needs an intro tip with a link to the add language page.

Examlpe:
Note: To make use of this page you must first <a href="[site:url]/admin/config/regional/language">add a language</a>

I will start back working on this now the token bug is fixed

pwieck, I didn't realize that you were already working on this and so I created a small tour for this page (admin/config/regional/translate). I will join my patch here but if you have already worked on your side, I hope you'll post your tour as well.

I am not sure if I've included all the functionalities of the page on the tour and if everything I've written about them is correct. And I hope that English speakers will revise the language when needed :). This is a kind of draft to be improved.

There are 8 steps on the tour but on an English language installation without added languages only 6 of them will be displayed.

@Outi, Maybe in the future you should pay more attention and even ask before starting an issue. I was just side tracked after I discovered the bug in tokens that made the links you used even possible. @Kristen Pol, sorry but I'm out on these tours. Like others here, my time is too valuable to work on something for nothing.

pwieck, I'm sorry, I was really hesitating if I should post my patch at all or not because I didn't want to make you feel having worked for nothing. I asked advice and as I was encouraged to post it anyway, I did. But as I said I hope that you would post yours, too, because it might be much better than mine and I don't mind if we don't use mine because I know that you were on this issue first. And I learned that I should pay more attention!

Tour needs tests since we now have #2028535

Updated issue summary.

There is a trailing space after label: Translation language

I have fixed the trailing space, some stylings, and removed the erronous last three lines from the patch.

Rerolled the patch from the appropriate commit.

So I updated this tour so that it has the same structure than the views_ui tour has now. I added the route_name array.

Just some rephrasing for step 4

label: 'Filtering the search'
body: 'You can choose wether you search in all the words and sentences or if you want to filter. You can search for untranslated strings if you want to translate something that isn''t translated yet. If you want to modify an existing translation, you might want to search only for translated strings.'

I'll look into the test issue later

I also edited the docs
https://drupal.org/developing/api/tour
for the problem I had not seeing the tour yaml file in my active/staging config

added my string corrections and removed route yaml since is already declared in routes (making tests fail)

I just wanted to see what was making the testbot fail. I'll try to work on the test this evening at drupaldevdays

I think ready and explains well how the interface for translation works

Ups I forgot the rebase, that's the reason for the big patch

If you want to review this apply the patch, enable locale and tour go to /admin/config/regional/translate and you should see a tour link at the right top, take it (8 steps) and check spelling.

To test this you also need to enable tour, translation, and configuration translation.

Changed the patch so texts are a bit more logical or better structured:

-    body: 'This page allows you to translate texts of the user interface of your site and modify existing translations. If you have installed your site initially in English, you must first add another language on your site on the <a href="[site:url]/admin/config/regional/language">Languages page</a> in order to use this page.'
+    body: 'This page allows you to translate the user interface or modify existing translations. If you have installed your site initially in English, you must first add another language on the <a href="[site:url]/admin/config/regional/language">Languages page</a>, in order to use this page.'

People who want to translate the interface of their Drupal site, know that they will be translating content on their site only. No need to specify 'On your site'

-    body: 'If you have several languages installed in your site, choose the language you want to translate.'
+    body: 'Choose the language you want to translate.'

The last popup already explained that you will need multiple languages.

-    body: 'If you want to translate a specific word or sentence, you can write it or a part of it in this field.'
+    body: 'Enter the specific word or sentence you want to translate, you can also write just a part of a word.'

Less complex sentence but with same information

-    body: 'You can choose wether you search in all the words and sentences or if you want to filter. You can search for untranslated strings if you want to translate something that isn''t translated yet. If you want to modify an existing translation, you might want to search only for translated strings.'
+    body: 'You can search for untranslated strings if you want to translate something that isn''t translated yet. If you want to modify an existing translation, you might want to search only for translated strings.'

Cleaner sentence.

-    body: 'When you have finished your translations, click on the <em>Save translations</em> button. You must save your translations each time before changing the page or making a new search.'
+    body: 'When you have finished your translations, click on the <em>Save translations</em> button. You must save your translations, each time before changing the page or making a new search.'

Added a ","

-    body: 'The translations you have made here will be used on your site''s user interface. If you want to use them on another site or modify them on an external translation editor, you can <a href="[site:url]/admin/config/regional/translate/export">export them</a> on a .po file and <a href="[site:url]/admin/config/regional/translate/import">import them</a> later.'
+    body: 'The translations you have made here will be used on your site''s user interface. If you want to use them on another site or modify them on an external translation editor, you can <a href="[site:url]/admin/config/regional/translate/export">export them</a> to a .po file and <a href="[site:url]/admin/config/regional/translate/import">import them</a> later.'

Export them to instead of export them on.

Thanks for reviewing and correcting. I agree with your changes of the strings. An interdiff would have been nice

For the test I'm pretty sure you only need tour and locale modules (There's no module called Translation)

About the other tours that are specified in the issue summary I really don't see the point of having them when you already have text in the interface that explain quite good the options, there's no boxes to point at.

For this reasons I'm marking it as RTBC

Thanks for the language revision. I would only like to add a point or a semi colon to the third step, between the "Enter the specific word or sentence you want to translate" and "you can also write just a part of a word", but I don't know if it's worth of a new patch :).

By the way, if you test this in a site that's installed in another language than in English, the necessary modules are already installed. Seemingly that means also that if you apply the patch after the installation, you must manually copy the .yml file to the configuration files.

Oh no, did I accidentally delete the latest patch? I'm so sorry, here it is again!

29: ui-translation-tour-2017475-25.patch queued for re-testing.

it was a random test failure, rather than anything wrong with the patch.

Adding to the D8MI Sprint board

Committed ec9d52b and pushed to 8.x. Thanks!

Yay. thanks!