クロスプラットフォームライブラリとAPI
Qt Creator IDEと生産性向上ツール
UI compositionのためのUIデザインツール
Qtプロジェクト向け
モバイルアプリのデジタル広告
受託開発、トレーニング、サポート等
組み込み向けユーセージ分析
Qtは、UIデザインやソフトウェア開発から品質保証、展開に至るまで、製品開発ライフサイクル全体で生産性を向上させます。あなたのニーズに最も適したソリューションを見つけてください。
最新のリソースを入手し、今後のイベントを確認しましょう。
理想的な学習リソースを見つけたり、コミュニティと交流したりして、Qtのスキルを向上させましょう。
初心者であろうとベテランのQtプロであろうと、成功するために必要なサポートと助けがすべて揃っています。
4月 18, 2012 by 松本 忠顕 | Comments
この記事は Qt DevNet Blog の "Doc Notes - We Have a Vision" を翻訳したものです。
執筆: Alexandra, 2012年3月22日
Qt のドキュメントを Qt Developer Network に移行するという話を始めた時、Marius は彼のイメージするものを説明する為に PHP のドキュメントを例に挙げました。そこには PHP グループによってたくさんの注釈が追加されたドキュメントがありました。これらの追加された内容が、いろんな意味でドキュメントとしての役割をもっていました。
Qt のドキュメントがトップレベルであることは明らかですが、従来の静的なやり方ではとても大きなチャンスを逃すことになります。皆さんのように、たくさんの経験のあるプログラマーが毎日クラスドキュメントを見ています。Qt をさまざまな環境で試し、さまざまなことを実装し、たくさんのことを知っています。とっておきのソリューションや、ちょっとした裏技、お気に入りのユースケースなどをお持ちのことでしょう。
経験あるテクニカルライターが作るドキュメントは素晴らしいものですが、このクラスドキュメントに皆さんの注釈を加えることによって、さらに進化させることができるはずと考えました。
そのページのクラスに関係のあることは全て注釈としてつけることができます。例えばクラスの使用目的や、使用例を説明するコード、そしてクラス実装の説明などが考えられます。よくある間違いを避けるヒントや賢い使い方なども良いでしょう。関連した wiki のチュートリアルやフォーラムのスレッドへのリンクがあると、そのクラスの背後にあるものを知りたい時や API の使い方を学習している時に便利かもしれません。
さらに、より詳細なサンプルコードがあれば実際にコンパイルして学習することができます。コードは純粋なドキュメントをより生きたものにし、クラスリファレンスよりも詳細な情報を与えてくれます。これらのサンプルは Qt を始めたばかりの人たちには大きな力となるでしょう。
では、アイデアの元となったものを見てみましょう。PHP ドキュメント の date 関数のページです。公式ドキュメントの部分は分かりやすく、十分に目的を果たしています。しかし PHP のユーザーはその関数にまつわる実用的な情報をさらに追加したいと感じました。
私は PHP のデベロッパーではありませんが(というか、デベロッパーではありません)、これがいかに便利かはすぐに分かります。注釈を検索すると私のような初心者でもすぐに重要な情報を見つけられるので、かなりの時間を節約できます。こういった情報は「公式な」ドキュメントには見つかりません。
12年間でどれだけの貴重なコンテンツが蓄積されたか、考えてみるとかなりすごいことです。もちろん、その全てが素晴らしい情報というわけには行きません。理想とは言いがたいものもあります。
というわけで、最も役に立つ注釈が最初に表示されるように、既存のコンテンツ向け評価システムを適用しました。サイトの他のコンテンツと同じように、高評価をつけることができますし、この機能に関しては、管理者に報告する意味で低評価をつけることもできます。
いかがですか?Notes 機能の役割について、Qt のドキュメントの方向性について理解の助けになれば幸いです。皆さんならドキュメントにどんな注釈をつけますか?いつものように、提案や改善案は大歓迎です。コメント欄にお書き下さい(訳注:元記事 へのコメントが確実です)。
Download the latest release here: www.qt.io/download.
Qt 6.8 release focuses on technology trends like spatial computing & XR, complex data visualization in 2D & 3D, and ARM-based development for desktop.
Check out all our open positions here and follow us on Instagram to see what it's like to be #QtPeople.
10 2, 2024
本稿は「Qt Contributor Summit 2024: Highlights」の抄訳です。 (Photo Credit:..
Qt Group includes The Qt Company Oy and its global subsidiaries and affiliates.