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

**デフォルトの名無しさん** · 2025/01/14(火) 14:35:20.50

なぜなのだろう？

**デフォルトの名無しさん** · 2025/01/14(火) 15:00:12.57

自動翻訳

**デフォルトの名無しさん** · 2025/01/14(火) 15:03:16.11

機械翻訳

長すぎる能書き

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

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

**デフォルトの名無しさん** · 2025/01/14(火) 15:11:44.72

開発が中国

**デフォルトの名無しさん** · 2025/01/14(火) 15:16:53.58

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

**デフォルトの名無しさん** · 2025/01/14(火) 15:21:41.08

用語が独特

**デフォルトの名無しさん** · 2025/01/14(火) 20:04:11.85

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

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

**デフォルトの名無しさん** · 2025/01/17(金) 16:55:36.24

>>3
>長すぎる能書き

ほんそれ

**デフォルトの名無しさん** · 2025/01/18(土) 02:38:14.33

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

**デフォルトの名無しさん** · 2025/01/20(月) 13:50:08.85

独自用語の使い過ぎ

**デフォルトの名無しさん** · 2025/06/09(月) 18:53:39.38

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

**デフォルトの名無しさん** · 2025/06/09(月) 20:05:50.01

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

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

**デフォルトの名無しさん** · 2025/06/11(水) 04:25:55.98

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

**デフォルトの名無しさん** · 2025/06/11(水) 09:24:40.49

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

**デフォルトの名無しさん** · 2025/06/13(金) 18:13:37.19

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

**デフォルトの名無しさん** · 2025/06/13(金) 19:28:21.47

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

**デフォルトの名無しさん** · 2025/06/14(土) 10:33:17.09

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

**デフォルトの名無しさん** · 2025/06/14(土) 13:39:18.16

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

**デフォルトの名無しさん** · 2025/06/15(日) 12:03:57.01

helpとreferenceは違う

**デフォルトの名無しさん** · 2025/06/17(火) 01:32:23.34

それは Microsoft が Microsoft だからだ。

**デフォルトの名無しさん** · 2025/06/17(火) 07:28:56.24

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

**デフォルトの名無しさん** · 2025/06/17(火) 07:38:10.33

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

**デフォルトの名無しさん** · 2025/06/17(火) 23:46:33.06

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

**デフォルトの名無しさん** · 2025/06/18(水) 00:04:18.71

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

**デフォルトの名無しさん** · 2025/06/18(水) 17:23:10.71

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

**デフォルトの名無しさん** · 2025/06/18(水) 17:23:50.09

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

**デフォルトの名無しさん** · 2025/06/18(水) 17:38:36.90

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

**デフォルトの名無しさん** · 2025/06/18(水) 18:59:10.40

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

**デフォルトの名無しさん** · 2025/06/20(金) 11:20:37.15

$ man ko

**デフォルトの名無しさん** · 2025/07/08(火) 12:47:25.52

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

**デフォルトの名無しさん** · 2025/10/22(水) 02:01:24.05

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

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

**デフォルトの名無しさん** · 2025/10/22(水) 15:58:30.50

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

**デフォルトの名無しさん** · 2025/10/22(水) 16:11:10.43

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

**デフォルトの名無しさん** · 2025/10/22(水) 20:44:41.85

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