Updatable Help speaks only English! What’s up with that?

Updatable Help speaks only English! What’s up with that?

Rate This
  • Comments 5

Our customers have certainly not been shy about their interest in multiple languages of Windows PowerShell Updatable Help, and we're grateful to hear how much they would value localized Help. Our challenge is this: Updatable Help is a new feature for this release of Windows PowerShell, and we have so very many new cmdlets and modules for Windows PowerShell 3.0 (over 2,300 new cmdlets in 95 modules). It takes time to translate the content once it's available in English, and we can't translate all of it. There's just too much new content. One of the Windows PowerShell Core modules just by itself contains over 87,000 words, meaning it's roughly the same size as Jane Austen's Persuasion, or J.K. Rowling's Harry Potter and the Chamber of Secrets. That's one module. We must make judicious choices about which modules get localized, and which are the most sought-after languages.

To determine which modules most urgently require translated Help, we're looking primarily at the number of page views of the cmdlet Help topics in the TechNet Library. Although we don't yet have the full picture at just five months after General Availability, this is giving us a good idea of which of the new modules are most read by our customers. Here's a look at the current page view count for the top three non-Core modules, for example:

Module Name Page View Count
Hyper-V 114701
Storage 48653
PrintManagement 23915

We're also viewing suggestions filed on the Microsoft Connect feedback website for Windows PowerShell. Some of our customers are filing suggestion bugs for getting the Updatable Help translated into languages that they'd like. We welcome and are reviewing these suggestions, too; but again, we will not be able to localize all modules of Updatable Help at this time. Additionally, it's unlikely that there will be support for languages beyond those in which Windows Server 2012 was shipped. The languages in which the first-localized modules would most likely be available, within three to six months from now, are the following four:

  • Chinese (Traditional)
  • French
  • German
  • Japanese

While other languages might be supported, these are the most likely languages, based on known consumption of Windows Server (and other server and management software from Microsoft, such as the System Center suite, or SQL Server) in non-English languages. We are still open to considering additional language support for Windows PowerShell. Furthermore, we continuously update the localized content, potentially adding new languages, and new topics in previously-available languages.

Please do continue to give us your feedback about languages that you'd like to see, and the updatable Help that's most valuable to you. And vote with your browsing, by viewing the cmdlet reference topics in your preferred language.

Thanks for your patience, while we work to get our international customers the module Help that they need the most.

The Windows PowerShell Team

Leave a Comment
  • Please add 8 and 4 and type the answer here:
  • Post
  • Hi, thanks for sharing this Information. But it would be great and give you some more time to finish the translations if we could use the english help in an other language OS.

    At the Moment there is no -Culture Parameter in get-help to use the english help.

    connect.microsoft.com/.../please-add-documentation-in-german-language-for-powershell-3-0

    Workarounds are a Proxy function or to copy the english help in the Folder for the OS Culture.

    Thanks!

  • Why don't you allow your users to translate the Cmdlet help and upload them to a central repository? Since collaboration has become so prevalent in the IT industry this just makes sense. I'd certainly help translate the help files to German.

  • At least using the English help on a German Windows works now:

    Update-Help -UICulture en-US

    and I can show the examples etc. in a (PowerShell) class.

    Somehow this didn't work for me in the past.

    PS: There had been no "Christmas present" last year;)

  • Thanks for your great Windows PowerShell Team.

    The number of users using Chinese Simplified more than Chinese Traditional. But latter firstly be supported than the former. it is a interesting scenario in most of Microsoft products.

    Pingback from: www.pstips.net/updatable-help-speaks-only-english-whats-up-with-that.html

  • Get-Help Add-Member -Online

    for instance, does not show the correct help page.

    It should show the help page for PSv3 (I'm using Win8 Pro pt-BR), instead, it shows the page for PSv2 (in my language).

    Add-Member cmdlet has new functionality in PSv3, which I'm not allowed to see in help page for PSv2, of course.

    I posted this bug in connect.microsoft.com/.../get-help-cmdlet-name-online-is-not-showing-the-most-updated-online-help-web-page-ps-v3-0-in-my-language.

    Unfortunately, the explanation text has been messed up by someone/something, and I haven't received any reply so far.

Page 1 of 1 (5 items)