ROCm™ ドキュメントサイト: 新たな旅立ち
2023-09-11更新
ROCm™プラットフォームのドキュメントサイトが待望の更新を遂げました。AMDは、新しいROCmドキュメントサイトをROCm.docs.AMD.comで公開しました。
ROCm Docs サイトのフェーズ 1 は、以下のようなあらゆる面でより良い設計となるようにデザインされました:
・ユーザー・エクスペリエンスと検索の向上
・新しいDaC(docs as Code)モデル
・既知の問題についての追跡結果と新しい問題提出ポータル
・新しいコンテンツの更新
ユーザー体験の改善
今回、ROCm ドキュメントのどのバージョンを閲覧しているかがわかりやすく表示されるサイドナビゲーションバーを追加し、これまで以上に使いやすくなりました。これにより、ユーザーは常に自分がどのバージョンの ROCm プラットフォームのドキュメントを閲覧しているかを確認できます。これは新しい統合検索機能にも適用され、ROCm プラットフォームの特定のバージョン内で正確な単語やコードスニペットを検索できるため、実行中のバージョンに特化した結果が返ってくることになります。
インストール手順も改善され、内容が凝縮され、各オペレーティングシステムの上部にタブが追加されました。GPUとOSのサポートに関する記述も一新され、AMD GPUファミリーごとにグループ化され、ナビゲーションが容易になりました。
ROCmドキュメントには、新しいGitHubコミュニティ、AMD Lab Notesブログ、GitHubサポートポータルなど、その他の有用なリソースへのリンクが追加されました。また、このサイトには便利なライト・モードとダーク・モードの設定があり、ユーザーは好みに合わせて外観をカスタマイズすることができます。
ドキュメント・アズ・コード(DaC)
AMDは、ROCmのドキュメンテーションにDocs as Code (DaC) モデルを採用したことを発表しました。これにより、AMD社内またはROCmコミュニティ の一員であるROCmプラットフォーム開発者は、コード開発時に使用するのと同じツールやプロセスでドキュメンテーションの寄稿、追加、改訂、修正を行えるようになりました。DaCでは、gitツールを使用してROCmドキュメンテーションのバージョンを管理することができ、ROCmドキュメンテーションと実際のROCmコードリポジトリを密接に連携させることができます。
ROCmのドキュメントをDaCに移行することで、ROCmコミュニティのメンバーがROCmのドキュメ ント作成に直接参加・貢献し、変更要求や問題報告、改訂や新規コンテンツの追加を行うようになることが期待されています。私たちは、ROCmプラットフォーム・コミュニティとの連携が今後の成功の鍵であると確信しており、DaCは私たちのビジョンを実践に移すための一助となることでしょう。
問題追跡
ROCmでは現在、GitHubを通じて不具合、問題、エラッタ、バグレポートを追跡しています。 また、GitHubを通じた新しいドキュメンテーションの課題提出も奨励しています。ユーザーは問題を提出し、AMDのROCmプラットフォーム・チームから迅速な回答を得ることができます。GitHub上の課題は、GitHubラベルを使用してROCmのバージョンごとに追跡されることになります。つまり、GitHub上で、特定のROCmプラットフォーム・リリースの課題をフィルタリングすることができるのです。(この機能の完全な展開は今後数週間で完了する予定です)
コンテンツの更新
ROCm ドキュメントサイトと閲覧環境の更新に加え、Composable Kernel や hipBLASlt に関するドキュメントなど、多くの新しいドキュメントが ROCm Docs に追加されました。リリースノートも更新され、リリースごとにコンポーネントが変更されているかどうかが明確に示されています。その他の新コンテンツは、ROCmでのDockerの使用、GPU分離技術、ROCmでのCMakeの使用方法の更新記事などをカバーしています。
近日公開予定
ROCm Docsには、近い将来さらにエキサイティングなアップデートが予定されています。Diátaxis (ディアタクシス(diataxis.fr)) – 技術文書オーサリングのための体系的なフレームワーク – が ROCm ドキュメントの構造基盤として正式に採用される予定です。 コンテンツの改善と拡張も計画中です。ROCmを最大限に活用していただくため、私たちはドキュメントの更新を、こだわりを持って進めていきます。
みなさんは、何をお待ちでしょうか?
ぜひ新しいROCmドキュメントのサイトをご覧いただき、その素晴らしい機能の数々をご自身の目でお確かめください。今後数週間のうちに、開発者の皆様の旅路に役立つ ROCm Docs の機能拡張をご紹介していきますので、ぜひブログにお立ち寄りください。
ROCm プラットフォームをより使いやすく
ROCmのユーザーと開発者のために、AMDはROCmをより使いやすく、より簡単にシステムに導入できる方法を継続的に模索し、その努力をサポートする学習ツールと技術文書を提供しています。
役立つリソース
・ROCmのウェブページでは、プラットフォームの概要とその内容、HPCおよびAI市場とサポートするワークロードを紹介しています。
・ROCm情報ポータルはユーザーと開発者向けのポータルで、ROCmの最新バージョンとAPI、サポートドキュメントが掲載されています。また、このポータルでは、ROCmプラットフォームを新規ユーザーに紹介するためのROCm学習資料や、既存ユーザーがROCmプラットフォーム上でシステムを開発・展開する際に役立つ厳選されたビデオ、ウェビナー、ラボ、チュートリアルを提供しています。
・AMD Infinity Hubでは、ROCmがサポートするHPCアプリケーションやMLフレームワークの詳細、最新バージョンの入手方法、インストールドキュメントを提供しています。また、ROCm対応アプリケーションの最新リストを含むROCmアプリケーション・カタログにもアクセスできます。
・最後に、AMD Instinct™ MI200シリーズ・ファミリーのアクセラレーターとパートナー・サーバー・ソリューションの詳細については、AMD Instinctサーバー・ソリューション・カタログをご覧ください。
シドニー・フリーマンは、AMDのシニア・プロダクト・マーケティング・スペシャリストです。彼女の投稿は彼女自身の意見であり、AMDの立場、戦略、意見を代表するものではありません。サードパーティのサイトへのリンクは便宜上のものであり、明示的に記載されていない限り、AMDはリンク先のサイトのコンテンツについて責任を負わず、いかなる保証も意味するものではありません。
こちらの記事はAMD本社のブログ記事を機械翻訳したものです。詳しくは元記事をご覧ください。