SHOEISHA iD

※旧SEメンバーシップ会員の方は、同じ登録情報(メールアドレス&パスワード)でログインいただけます

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

テクニカルライティング作法・外伝

「オリジナルを探せ!」~ソフトウェア開発者に贈るテクニカルライティングの極意

テクニカルライティング作法・外伝 第5回

  • X ポスト
  • このエントリーをはてなブックマークに追加

 テクニカルライティングに役立つ(かもしれない)話をあれこれと書く連載。第5話は、情報を調べるときには原典も確認しようという話です。

  • X ポスト
  • このエントリーをはてなブックマークに追加

はじめに

 プログラミングに関するブログや解説記事を書くときに、いろいろ調べますよね。ググって、答が載っているブログ記事を見つけて、「そうか!」と。コーディングしているときなら、そこがゴールです。後はコードを書いてみて、ちゃんと動けばOK。ですが、ブログや解説記事といったテクニカルライティングのときはそこで止まってはいけません。テクニカルライティングの3C第1話参照)の1つCorrect(正確さ)を担保するために、原典(オリジナル)も確認しましょう。

 今回は、プログラミングの問題を調べるときのコツをいくつか紹介します。

まず理解⇒原典で確認
答が分かればいいプログラミングと、その正確さも要求されるテクニカルライティング

対象読者

  • テクニカルな文章を書いている人/書かなきゃならなくなった人
  • その中でも、とくにソフトウェア開発に関わっている人

 テクニカルライティングの領域は広いですけど、この連載ではソフトウェア開発に関連した文書を主に想定しています。

まずは答が欲しい

 解説記事を書くときに、分からないことが出てくることがあります。分かっているつもりで書き始めても、途中で「あれれ?」となることも。そんなときはまずググって答を探してみると思います。これは読者のみなさんも慣れたものでしょう。わざわざ書くまでもないかもしれませんが、私(筆者)がプログラミング関係の記事を書くときに実践しているやり方を紹介します。

プログラミング言語やプラットフォームをキーワードに加える

 例えば、WindowsのUWPアプリで画像や文字などのオブジェクトの周囲に影のようなビットマップエフェクトを付ける方法を探しているとしましょう。

 「ビットマップエフェクト」だけでググると、他のOSでのプログラミングや、画像処理アプリの使い方などもヒットしてしまいます。そこで、プログラミング言語とプラットフォームも追加して「ビットマップ エフェクト c# uwp」でググってみると、それっぽい記事がいくつか見つかります。

 なお、検索キーワードが全て英語の場合、例えば「bitmap effect c# uwp」でググったりしたときは、英語の記事も大量にヒットします。私もそうですが、英語があまり得意でないのなら、検索結果を日本語だけに絞り込んでみましょう。

新しいものだけに限定する

 上のようにして見つけた中からそれっぽい記事「ビットマップ エフェクトというかピクセル シェーダーっていうか、まぁそういう効果を XAML で楽して書きたいよね♪」を開いてみると、UWPではなくて、Windows 8時代のものでした。がっかりです。

 そういうときは、新しいものだけに絞り込みましょう。たいてい私は、まず最初に操作が簡単な1年以内で絞り込んでみます。ここではUWPアプリがリリースされた(つまりWindows 10がリリースされた)2015年7月以降を指定して検索してみましょう。

 なお、ご存知とは思いますが、Googleで検索した結果を言語や期間で絞り込むには、[ツール]ボタンをクリックしてオプションを表示させます。Bingの検索結果には、初めから言語や期間で絞り込むオプションが表示されています。

使うAPIが分かったらそれで再検索してみる

 上で絞り込んだ結果の中に、UWPでテキストに影をつける方法を解説しているブログ記事を見つけました。Win2DというライブラリーのShadowEffectクラスを使ってコーディングしてやれば実現できるようです。ただ、この記事に載っているコードはちょっと面倒そうでした。もっと楽な方法がないか、今度は使うAPIで検索してみましょう。

 使うAPIをキーワードにして「win2d shadoweffect uwp c#」でググってみます。残念ながら日本語ではめぼしい記事がないので、がんばって英語の記事を見ていきます。すると、「UWP: Create shadow in XAML」という掲示板の記事に"The easiest way is to use the DropShadowPanel from UWP Community Toolkit."(最も簡単なのはUWP Community ToolkitのDropShadowPanelを使うことだよ)という1文が! UWP Community ToolkitのDropShadowPanelを見ると、たしかに簡単にできそうです(次の画像)。良さそうな答が見つかりました。

UWP Community ToolkitのDropShadowPanel
UWP Community ToolkitのDropShadowPanel
DropShadowPanelコントロールの中にImageコントロールを配置するだけで画像に影を付けられる

 今回はそのものズバリのライブラリーが見つかりました。利用するAPIでの再検索はぜひやってみてください。最初に見つけたものよりも簡単だったり詳細だったりする記事を発見できることがよくあります。

会員登録無料すると、続きをお読みいただけます

新規会員登録無料のご案内

  • ・全ての過去記事が閲覧できます
  • ・会員限定メルマガを受信できます

メールバックナンバー

次のページ
テクニカルライティングの正確さを担保するためオリジナルに当たる

関連リンク

この記事は参考になりましたか?

  • X ポスト
  • このエントリーをはてなブックマークに追加
テクニカルライティング作法・外伝 連載記事一覧

もっと読む

この記事の著者

biac(ばいあっく)

HONDA R&Dで自動車の設計をやっていた機械屋さんが、技術の進化スピードに魅かれてプログラマーに。以来30年ほど、より良いコードをどうやったら作れるか、模索の人生。わんくま同盟の勉強会(名古屋)で、よく喋ってたりする。2014/10~2019/6 Microsoft MVP (Windows Devel...

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

この記事は参考になりましたか?

この記事をシェア

  • X ポスト
  • このエントリーをはてなブックマークに追加
CodeZine(コードジン)
https://codezine.jp/article/detail/11454 2019/04/17 11:00

おすすめ

アクセスランキング

アクセスランキング

イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

新規会員登録無料のご案内

  • ・全ての過去記事が閲覧できます
  • ・会員限定メルマガを受信できます

メールバックナンバー

アクセスランキング

アクセスランキング