Charles,
My apologies! I saw "I created my own" and thought it's about the layout while it was about the documentation.
As for "Apple" way vs "Windows 8" way - it's about MS Windows: 3.1-7 vs 8 and not really a personal preference, it's (at least) 15-year experience reported by many users of the following two different ways of represent Russian letters with mnemonic/phonetic
approach:
1) no combination. As regular Russian layout _system_ input, mnemonic is the same - 1 click for 1 letter. All a user needs is to memorise is a set of 6-7 positions. It takes maximum 2 weeks - and useful for years, as it's "system" way - proven by experience
of numerous users of _system_ Phonetic layout for Russian under MS Windows (since 1997 when it was first offered on US site SovInformBureau" by V. Maslov)
So, one time 2 weeks and no more issues. Unlike:
2) with combinations - many Web sites offered - since 1997 - same way (exact same way) as Windows 8 offers now. Numerous tests made by people - it's millions as you can see on the Vistors Counter on of the famous tool that does "the combinations" way -
http://translit.ru
Here people have been reporting - for years the problem that cannot be solved (Russian language is too rich, there is no pre-built list of "exclusions", a tool can one fixed but not another):
combinations are often confused with "normal" letter sequence, for example (again, if one specific example does work in Windows 8, it means nothing - some other Russian words would present same problem):
'vyuchil' - 'yu' is recognized as a combination (while it's not) and produces "bad word" - "вючил"
'rajon' - 'jo' is recognized as a combination (while it's not) and produces "bad word" - "раён"
'schitayu' - 'sch' is recognized as a combination (while it's not) and produces "bad word" - "щитаю"
...
Yes, a space bar (or '+' in case of translit.ru as its author explains -
http://translit.ru/help/faq/#question11) can solve that, but people complain that in addition to thinking about the text you typing, you need -
constantly (unlike case 1) ! -
think whether it's a "special need" word (and thus place a space bar) or a normal word - most people found it extremely annoying and tedious :(
Russian-language forums around the world (only them need mnemonic layout, not in Russia itself) are full of complaints regarding "bad Cyrillic" (since 1997) -
when people fail to recognize "special need word" and produce meaningless words.
If you read Russian - typical complaints (very short page made way before Windows 8):
http://cvt.WinRus.com
It has been discussed zillion times since 1997 - not as "Apple" approach vs "Windows 8" but as
"Mnemonic layout as regular Russian system layout - 1 click - 1 letter"
vs
"Guessing algorithms of converting Latin text with combinations to Cyrillic"
Because in 2nd case a person will have to struggle with "guessing" issues all the time, for years while in 1st case - just learn 6-7 positions (takes 2 weeks) once.
Russian-speaking people, from Australia to Germany , usually say (and it's why Phonetic system layout for Windows 95/98/2000/XP/Vista/Windows 7 is used much wider than "combinations convertion" tools):
"we have learned a whole new language when we came to a new country, so it's not hard to learn 7 positions of system phonetic layout rather than use translit.ru and check all the time whether it's a "special need" thing - and thus place a space bar - or not.
I really don't know how Windows 8 team came up with this, "combination" way because since Windows 3.1 people used non-combination way for Windows - 1:1 Phonetic layouts made with 3rd party 'layout editors' which could create only "1:1" layout and since XP -
Microsoft's "MS Keyboard Layout Creator" (MSKLC) - http://msdn.microsoft.com/en-us/goglobal/bb964665.aspx which makes only "1:1" Russian layouts:
a) hundred thousands Russian speaking people outside Russia, from US to Japan and Spain
b) people for whom Russian is a language they learn/teach - they use Phonetic "1:1" mnemonic layouts suggested by
http://AATSEEL.org (made by MSKLC or other 'layout editors' before XP) and such layouts have been used (installed) for many years in the Slavic labs of such Universities as Harward, Prinston, UCLA, etc.
That is, it's why the person who started that topic and me also complained about "missing letters" - we could not guess that MS suddenly takes "combination" approach as we KNEW - for years - that under Windows, starting even from Windows 3.1 and then all the
way to Windows 7 - so many people got used to "1:1" mnemonic/phonetic Russian layout.
So Apple really has nothing to do with the situation - it started to offer Russian mnemonic layout only recently, while under Windows people used _system_ mnemonic layout (as "RU" and as an alternative to standard Russian layout) for years and years.
Again, Microsoft would know those facts - about Russian-speaking people and about AATSEEL members (for example, the author of MSKLC - Michael Kaplan - knows those facts very well as he has been contated by such people since MSKLC appearance on the market) and
thus it's strange that they suddenly decide to go another way (troublesome way!) and it's why I personally thought that Windows 8 has missing letters - as I know the situation and follow it since 1993 I gues, when I first used mnemonic layout for Windows 3.1
("1:1" layout as any 'layout editors' offered only this way)
:)
Most people who need mnemonic find more logical just to type Russian text as they would with standard Russian layout rather than use a space bar (unusual thing, as since Windows 3.1 they just type letters, either with standard layout of mnemonic)