microsoftdocs / globalization Goto Github PK

License: Creative Commons Attribution 4.0 International

PowerShell 0.01% HTML 100.00%

globalization's Issues

Links to old MSDN site

Links on the page below point to the old MSDN Library pages:
https://docs.microsoft.com/en-us/globalization/testing/testing-for-world-readiness

Navigation is broken on keyboard preview pages

I cannot properly navigate after I open some keyboard layout preview page:

Keyboard layout preview pages should be under this page in hierarchy:

Also, please add a link to Keyboard identifiers and input method editors for Windows somewhere on Windows keyboard layouts page.

Some topics are not hooked up to the TOC

By design?

For example: https://docs.microsoft.com/en-us/globalization/input/input

But then you have https://docs.microsoft.com/en-us/globalization/input/text-input which is associated with 2 entries in the TOC

They also tend to be the ones without the mandatory metadata header section

Direct keyboard layout pages shouldn't be accessed

When I googling for "Albanian Keyboard layout windows" I seeing direct link to the keyboard layout page (https://learn.microsoft.com/en-us/globalization/keyboards/kbdal.html)

but page with proper navigation (https://learn.microsoft.com/en-us/globalization/keyboards/kbdal) should should be opened instead.

Please make some changes to prevent this from happening.

MSKLC link dead

The MSKLC link at https://docs.microsoft.com/en-us/globalization/downloads is not working.

Consider fixing the 82315 and 17223 fwlinks and/or linking directly to
http://www.microsoft.com/en-us/download/details.aspx?id=22339.

(The latter fwlink is from https://support.microsoft.com/en-us/help/823010/the-microsoft-keyboard-layout-creator which is linked from the bottom of https://docs.microsoft.com/en-us/globalization/windows-keyboard-layouts.)

US keyboard layout shows spurious extra key that doesn't exist

The US keyboard layout shown at https://docs.microsoft.com/en-us/globalization/keyboards/kbdus_7.html (linked from https://docs.microsoft.com/en-us/globalization/windows-keyboard-layouts#U) shows two backspace keys. This is incorrect. The second backslash key between Left Shift and Z is unexpected; it doesn't exist on US keyboards.

The correct backslash is between
Backspace and Enter. https://upload.wikimedia.org/wikipedia/commons/5/51/KB_United_States-NoAltGr.svg

Essentially this is a weird impossible mix of ANSI and ISO https://deskthority.net/wiki/ANSI_vs_ISO

Where is this linked in the main learn site?

Sorry if this is not the right place to ask this, but the globalization overview page doesn't contain a feedback option. In summary, how can one access this resource just by following links in the learn.microsoft.com site, without specifically searching for it? (Also, if I search for globalization, I get more reference material about .net and Windows, but still this resource is not linked). I'm asking because I consider this a really useful resource (especially the terminology reference, in my case) and I think it's too hidden (or perhaps invisible if you don't actively look for it with a search engine).

3 broken links on Globalization Documentation main page - https://github.com/MicrosoftDocs/globalization/blob/live/globalization/index.md

This page has 3 broken links:

1. Getting Started with Globalization
https://github.com/MicrosoftDocs/globalization/blob/live/globalization/software-internationalization

2. Internationalization for Windows Applications
https://github.com/MicrosoftDocs/globalization/blob/live/windows/desktop/Intl/international-support

3. National Language Support
https://github.com/MicrosoftDocs/globalization/blob/live/windows/desktop/Intl/about-national-language-support

Control key is not considered as modifier on keyboard layout preview

Some keyboards have control key (scan code 1D) as and/or right control (scan code E0 1D) as modifiers and should behave as toggle keys on keyboard preview page.

For example Canadian Multilingual Standard Keyboard have many characters that can be only input with VK_OEM_8 (scan code E0 1D - right control key) or VK_SHIFT + VK_OEM_8 key modifiers and cannot be seen on keyboard preview.

Typo

There's a typo in the following:

The Russian Microsoft voice follows Engish (United States) voice.

https://docs.microsoft.com/en-us/globalization/localization/ministyleguides/mini-style-guide-russian

This docset has no PR Preview

I can't preview PRs on review.docs.microsoft.com

(Edited since now I can see the edit button)

Include keyboard identified on keyboard layout pages

This page now has a list of keyboard identifiers (KLID string) for each keyboard layout supplied with Windows, and a link to the corresponding layout:
https://learn.microsoft.com/en-us/windows-hardware/manufacture/desktop/windows-language-pack-default-values

Please include this identifier on corresponding keyboard layout pages. This way it will be easier to deal with keyboard layouts.

PS: Yes, there is much more information about layouts at https://kbdlayout.info/, but I wanted to improve the official source.

Unicode character formatting on keyboard layout pages

Single characters on popups should be formatted ALL UPPPERCASE as per 4.8 Name. Unicode Standard like this:
U+1033F GOTHIC LETTER URUS

Also, according to UAX #34 character sequences should be formatted as "Unicode named character sequence" like this:
<U+10339, U+0308> GOTHIC LETTER EIS WITH COMBINING DIAERESIS

names for named character sequences are constructed by appending the names of the constituent elements together while eliding duplicate elements, and possibly introducing the words “WITH” or “AND” between elements for clarity

Can you make corresponding changes?

National keyboard layouts page not working

https://docs.microsoft.com/en-us/globalization/windows-keyboard-layouts or the same at
https://github.com/MicrosoftDocs/globalization/blob/live/globalization/windows-keyboard-layouts.md

Does not work at all.
I tried Firefox with pop-up blocker disabled for microsoft.com and then tried MS Edge with pop-up blocker completely disabled and still nothing: click say on French or German or ... - nothing happens

German Keyboard: Caps Lock is Shift Lock

https://docs.microsoft.com/en-us/globalization/keyboards/kbdgr:
In reality Caps Lock acts as Shift Lock;, the upper row is incorrectly displayed as unshifted.
Please compare for example http://kbdlayout.info/kbdgr/shiftstates+virtualkeys/VK_CAPITAL / http://kbdlayout.info/kbdgr/shiftstates+virtualkeys/VK_SHIFT
https://docs.microsoft.com/en-us/globalization/keyboards/kbdgr1: is correct
http://kbdlayout.info/kbdgr1/shiftstates+virtualkeys/VK_CAPITAL / http://kbdlayout.info/kbdgr1/shiftstates+virtualkeys/VK_SHIFT

Maybe there are similar issues for other keyboard layouts too, e.g. https://docs.microsoft.com/en-us/globalization/keyboards/kbdfr

Strange translation of "Learn More" on Russian Language Portal page

"Learn More" is translated into Russian as "Выучить больше" on https://www.microsoft.com/ru-ru/language/

This a direct translation and it sounds silly. It should be something like "Узнать больше" or "Подробнее".

Document how Font fallback really works

Hello,

On this documentation https://docs.microsoft.com/en-us/globalization/input/font-technology there is no mention on how to configure Font Fallback or how it works

After a lot of experiment I was able to discover that at least GDI+ is using a logical font https://docs.microsoft.com/en-us/windows/win32/intl/using-ms-shell-dlg-and-ms-shell-dlg-2 withi is then substitute with the font substitution mechanism and then Tahoma or Microsoft Sans Serif is used.

I don't know if this can be generalize, but it would have saved me a few hours of research if I had know those fonts were used in this process.

United Kingdom layouts should show ISO keyboard

In the United Kingdom we use ISO keyboards (see https://deskthority.net/wiki/ANSI_vs_ISO ). However https://docs.microsoft.com/en-us/globalization/keyboards/kbduk.html
and https://docs.microsoft.com/en-us/globalization/keyboards/kbdukx.html show American-style ANSI keyboards:

The keyboards in the diagrams should look more like https://upload.wikimedia.org/wikipedia/commons/d/da/KB_United_Kingdom.svg . Compare the Enter keys (multirow vs single row)

https://docs.microsoft.com/en-us/globalization/windows-keyboard-layouts#U

There is missing

kbdinben
pre-XP
https://learn.microsoft.com/en-us/globalization/keyboards/kbdinben.html

------- Problem bellow -------

This keyboard has missing "।" keyword.
see as like as "kbdinbe2" keyboard "."
preview https://prnt.sc/vLSJ87frQ_gF
original link https://learn.microsoft.com/en-us/globalization/keyboards/kbdinbe2.html

and also, numeric key is not defaulting language key.
preview https://prnt.sc/spI67JPFZTM5

Ligatures are missing on keyboard layout previews

Gothic keyboard layout is missing some key character values:

Scan code 0x15 -> VK_Y -> 𐌹̈:

𐌹̈ U+D800 U+DF39 U+0308
	U+D800 U+DF39 = U+10339 GOTHIC LETTER EIS
	U+0308 COMBINING DIAERESIS

Scan code 0x29 -> VK_OEM_8 -> ̱̄:

̱̄ U+0331 U+0304
	U+0331 COMBINING MACRON BELOW
	U+0304 COMBINING MACRON

See for proper preview: https://kbdlayout.info/kbdgthc

I guess other layouts are affected too.

Most links are pointing to the old MSDN site rather than new pages on this site

Most links are pointing to the old MSDN site rather than new pages on this site.
See example below for
https://github.com/MicrosoftDocs/globalization/blob/master/globalization/software-internationalization.md

title: Software Internationalization
description: Fundamentals about software internationalization, which includes globalization, localizability, localization, and testing world readiness.
ms.assetid: 9c23e01d-81c8-4e00-8b1f-068bb63713c4
ms.date: 07/14/2017

Software Internationalization

Introduction

With the growing software market far beyond the English-speaking world, it's important for the software to support various text and data formats to reach all the potential customers. To make that happen, the most important step is to design the software with the internationalization in mind.

The below sections provide some generic information about the internationalization concepts—globalization, localizability, and localization.