なぜMicrosoftのドキュメントは読みにくいのか

なぜなのだろう？

自動翻訳

機械翻訳

長すぎる能書き

最後まで読んでも肝心の仕様が書かれてない

あれもこれも対応する玉虫色の設計思想だから典型的なユースケースが定まっていない

開発が中国

そもそもマイクロソフトのプロダクトが分かりづらい

用語が独特

機械翻訳だからとしても、
じゃあアメ公はああいうドキュメントが読みやすいと思ってるのかというと、
連中もそう思っていないのだろ

「分かってる人」が読むと、
まあそうだね、となるという、さ

>>3
>長すぎる能書き

ほんそれ

Copilotにドキュメントをコピペして「コード例をいくつか紹介して」

独自用語の使い過ぎ

初心者向けに書かれてないカラナ

MS-DOSやWin9x系の頃はそれなりに良いヘルプとして定評があったんだぜ
他のメーカーも真似をしてアプリの中から参照できるヘルプが当たり前になったしな

いつからおかしくなったんだろうな、HTMLヘルプになった頃からかなあ

Microsoft自身がよくわかってない

windowsのhelpは読まなくても判るようなことしか書いてなくて
開いてもがっかりするだけなので最初からもう目に入らない機能になってる

そもそもヘルプを見て使うレベルのユーザーがプログラマのわけがない。

プロじゃないプログラマーはただのグラマーだ

>>16
お前それ面白いと思って書いてんの?

>>15
リファレンスを読まないプログラマーなんていてはいけない

helpとreferenceは違う

それは Microsoft が Microsoft だからだ。

>>19
意味合いとしては違うが実態として区別されてないだろう
お前が違うと思うなら違うんだろうなという程度のことでしかない

似ているものを同じ物と見るか違う物と見るか

マイクロソフトは嘘説明をするからな

米国マイクロソフト社員がドキュメントについて語る記事
> アメリカの職場ではなぜドキュメントも無いのに人が去っても問題ないのだろう？
> note.com/simplearchitect/n/n3b83d966ed19
ドキュメントの考え方が日本と違う

これがいいとも思わない。
マイクロソフトって組織が多いから、いろんなグループ
がいる。どのグループが主導権を握るかで仕様やインター
フェースがコロコロ変わる。前の奴が作ったヘルプなんか
ゴミ処理だろ。

マイクロソフトって組織が多いから
　↓
マイクロソフトって組織が大きいから

横に逸れてすまないが、ヘルプって元はオンラインマニュアルを表示するソフトウェア機能のことで
「ツールチップヘルプ」「コンテキストヘルプ」「ヘルプファイル」のような使われ方してたよな
リファレンスはマニュアル文書の一種で「リファレンスを収録したヘルプファイル」というのは普通に存在してた
いつからかヘルプ自体が文書の意味になった

dosの頃はへhelpは機能だったな
>help

$ man ko

おまいらのあいどるちょまべび16ヶ月
完全に存在を忘れていた人工受精率

windows11 25H2になってUpdateも満足にできん。
で失敗したからと見に行ってもその通りにしても
うまくいかない。

Visual Studioでランタイムエラーが出るからと
マイクロソフトのサイトを調べても、その通り
にやってもうまくいかない。AIを導入している
せいか質が急激に低下している。第２のIntel
になるんじゃね？

とにかくマイクロソフトの社内用語を使いまくって
わかりにくい。

pwshのGet-Helpだけ分かりやすい後はｺﾞﾐｸﾂﾞ
Officeなんか97や95のchmファイルのヘルプの方が分かりやすかったんじゃないか

英語で書いて日本語に翻訳してるからでは
昔のアドビとかは日本で文書作ってたから、非常に読みやすかった

日本マイクロソフトはやる気がない

>>35
英語が出来るだけのボンクラしか居ないからね

msのweb上の日本語ドキュメントはだれでも治せるようだが
面倒臭いのでだれもやりたがらないんだろう
今でも技術的間違いどころか酷い(日本語ですらない)ものが蔓延している

>>37
AWSの日本法人もカタカナ語の多用で意味がわからなくなっている。

そもそも情報不足で書いてないという事も有るぞ

GoogleやAWSも全部そうだぜ
システム関連の技術資料は全部読みにくいわ