if developer_docs == bad then app_quality = bad; コーダーがAppleのAPIマニュアルの水準を批判

Apple の開発者たちは、iOS および macOS ソフトウェアの作成に頼っている iGiant のプログラマー向けドキュメントの現状に対する不満をますます声高に訴えるようになっている。

macOS開発者のマイケル・ツァイ氏は月曜日のブログ投稿で、同社の技術の利用に関するAppleの指示に不満を表明している数人のプログラマー仲間について言及した。

その中には、かつてAppleで働いていたベテラン開発者のスコット・アングイッシュ氏が、古いiOSドキュメントがアーカイブに移動され、現在はサポートされていないことをTwitterで指摘した。

「例えば、キーボードによってテキストフィールドがブロックされている場合など、最新のガイドラインは存在しないようです」と彼は続け、画面上の仮想キーボードによってテキストインターフェースの基となる要素が隠れてしまうという課題について言及した。「このような状況になるとは到底考えられません」

「信頼できるドキュメントがなければアプリを書くことはできない」と彼は詳しく説明した。

The Registerへのメールで、ツァイ氏はAppleのドキュメントがなぜこれほど劣悪な状態なのか分からないと述べた。「外部にいる私たちにとって、本当に可視性が低いのです」と彼は述べた。「Appleは新しいAPIや変更されたAPIをより速いペースで導入しているように見えるので、やるべきことはもっとあるでしょう。しかし、なぜ十分な人員を雇用できず、対応できないのか、あるいはまだ置き換えられていない古いドキュメントを隠したり廃棄したりしているのかは不明です。」

開発者は技術ドキュメントを非常に重視します。不十分または不正確な説明は、エラーやプロジェクトの遅延につながるからです。Mozillaは2017年にGoogleおよびMicrosoftと提携し、Mozilla Developer NetworkがホストするWebプログラミングハウツーガイドの改善に取り組みました。その目的は、より一貫性と整合性のあるドキュメントを提供することで、開発エクスペリエンスを向上させることでした。ちなみに、MozillaはSlashDataのDeveloper Choice Awards 2018 Digital Editionにおいて、開発者が選ぶ最も人気のドキュメントソースに選ばれました。

Apple にとって、標準以下のドキュメントは、開発者による標準以下のアプリがリリースされる可能性を高め、ソフトウェア プラットフォームの使い勝手を低下させます。

Anguish 氏の苦情に対して、同様の不満を抱える他の多くの開発者から返答が寄せられた。

「彼らのドキュメントに記載されている問題の量は驚くべきものだ」とソフトウェア開発者のチャーリー・フィッシュ氏は語った。

Itty Bitty Apps の主任開発者 Tony Arnold 氏は、「Apple の開発者向けドキュメントは今のところひどい」と語った。

「今Android開発をしていて本当に良かった」と、Twitchのモバイル開発者、ヒース・ボーダーズ氏は語った。「どうしてAppleがドキュメントをこんな風に放置していたのか、本当に理解できない」

「私の知る限り、これが（アプリ内購入の）レシート検証に関する唯一のドキュメントです」と、Adobe社で働く開発者のスティーブ・ティベット氏は指摘する。「これはAppleに数十億ドルの利益をもたらしている現行システムの一部です。しかし、そこにはエラーがあり、『もう更新されていない』状態です。」

ティベット氏は、もっと大きな何かが起きるかもしれないので、6月に開催されるアップルの世界開発者会議が終わるまで苦情を言うのを待つつもりだと付け加えた。

もしそうなら、それはAppleのMarzipanプロジェクトと関係があるかもしれません。これはiOSとmacOSの両方で動作するアプリを開発するための新しいインターフェースSDKであり、おそらく新しいドキュメントが必要になるでしょう。また、Objective-CからSwiftへの移行が進んでいるため、ドキュメントを最新の状態に保つことがさらに困難になっています。

しかし、ツァイ氏は、マジパンの移行を責めることはできないと述べた。「これは長年続いてきたことであり、マジパンが今日欠落している文書の必要性を補うことはない」と彼は述べた。

Appleの開発者フォーラムでは、過去1年間、開発者向けドキュメントの現状についていくつかの不満が寄せられてきました。「Appleフレームワークのオンラインドキュメントは、しばしば古くなっています」と、ある開発者が11月に書き込んでいました。「Swift 3（2016年9月リリース）で新しいDispatchQueueクラスが導入されましたが、developer.apple.comのドキュメントには、これらのクラスの機能やプロパティに関する情報がほとんど記載されていません。」

この種の苦情はさらに古くからある。

調子はどうだい、ドクター？ pic.twitter.com/vdTfCYUQlc

— ericasadun (@ericasadun) 2016年11月8日

The Registerは、Appleに対し、同社の文書に関する苦情についてコメントを求めた。iPhoneメーカーからの回答は期待できない。

ツァイ氏は、特にRadarバグ報告システムに関して、Appleがもっと迅速に対応できるはずだと同意した。「私が提出したRadarに対して、文書化などを含め、回答や修正をうまく得ることができていません」と彼は述べた。®