『技術者のためのテクニカルライティング入門講座』を読んだ
翔泳社セールで買った『技術者のためのテクニカルライティング入門講座』を読んだ。
- 作者:髙橋 慈子
- 発売日: 2018/11/19
- メディア: 単行本(ソフトカバー)
自分の文章のよくない癖を認識できた。
また、こうしたほうがいいと例が書いてあるのでわかりやすい。
特に参考になった部分をmemo
アンチパターン
・「〜だが」「〜ので」で文章をつなぎ、一文が長い
文が長いだけではなく、最も伝えたいことが最後に来てしまっている
・ 「〜が必要です」という文
相手に操作などを求める場合はより具体的に書くか言い切ってしまったほうがいい
・ 二重否定文
二重否定文は曖昧な表現になることも多く、読み手に不安を与えてしまう。
二重否定文は、否定している部分の両方を肯定文にするよう書き換える。
例「〜しないとは限らない」
こうしたほうがベスト
・操作は能動態、結果は受動態
操作説明書などに使用できるテクニック。
操作はユーザー視点の能動態で、結果は別の文に分けて受動態で書く。
・使用方法の説明では使役形を使わないほうがベスト
使役形とは「〜せる」「〜させる」のこと。
例「アイコンをタップさせ、アプリを起動させます。」
・箇条書きの最後の「など」は削除
例「ドライバーやレンチなどを用意してください」
→などは削除「ドライバーやレンチを用意してください」
もしくは、例示をまとめるものを書き加える方法もある。
「ドライバーやレンチなどの工具を用意してください」
例
●フルーツ
・りんご
・みかん
・バナナ など
→などは削除する
もしも他にもあることを強調したいなら(一部)を書いておく。
●フルーツ(一部)
・りんご
・みかん
・バナナ
iOSアプリを6個、Androidアプリを4個作りました
最近はアプリ開発を楽しんでいました。
iOSアプリを6個、Androidアプリを4個作りました。
↓以下作ったアプリのキャプチャなど
iOSアプリ
初めてのiOSアプリ
じゃんけんアプリと音楽を再生するアプリをチュートリアルでまず作りました
昨日と今日はiOSアプリを2つ作成しました!AutoLayoutむずいヾ(・ω・`;)ノ
— sakura (@818uuu) 2020年1月23日
マップ検索アプリ
ひまだったので一本💪
— sakura (@818uuu) 2020年1月25日
今日はマップ検索アプリを作ったよ
検索…!💌 pic.twitter.com/tr9v50qR6A
タイマーアプリ
今日はiOSタイマーアプリを作ったお(^ω^)⏰
— sakura (@818uuu) 2020年2月12日
参考書みながら作っています
segue遷移を初めて知りました
せぐえ…
あとぐるぐるpickerを設置しました
Xcodeがきつきつさんで困っています( ᷇࿀ ᷆ ) pic.twitter.com/E2Q5b93srt
カメラアプリ
今日はiOSカメラアプリを作りますた📷✨
— sakura (@818uuu) 2020年2月13日
カービィを撮ったよ
プロジェクト設定のInfoからプロパティリストで文言をカスタマイズできることを知りました
基本Apple準拠かと思ってた🍎 pic.twitter.com/pObZC4AAVs
ツイッターに投稿する部分がうまくいかないな( ´︵` )
— sakura (@818uuu) 2020年2月15日
できた!わーい pic.twitter.com/azWzGHuYeh
— sakura (@818uuu) 2020年2月15日
お菓子検索アプリ
今日はお菓子検索iOSアプリを作りました!🍰
— sakura (@818uuu) 2020年2月15日
「メロン」ってキーワード検索したらメロン味のお菓子が出てきます
(お菓子の虜Web APIを利用しています)
iOSアプリを合計6個作りました📱
『iPhoneアプリ集中講座』わかりやすかったです
明日からはiOSとは違うものをやってみます😊 pic.twitter.com/5576f3ud81
Androidアプリ
初めてのAndroidアプリ
今日はAndroidアプリを初めて作りました!(っ ' ᵕ ' c)
— sakura (@818uuu) 2020年2月16日
日本語、英語、フランス語の端末情報に合わせてボタンを押したときの挙動が変わるアプリです
昨日までiOSアプリを作っていたので、
Android StudioとXcodeの違いが知れて面白いです
Kotlinを使っています(・8・)✨ pic.twitter.com/lvbnYzUnPe
high and low
今日はAndroidアプリ
— sakura (@818uuu) 2020年2月17日
「high and low」ゲームを作りました🃏✨
左に表示されているトランプより
高いか低いかを当てます。
5回当たったら勝ち、外れたら負け
viewやbuttonが増えるに伴ってConstraintがたくさんになってきた
高いよなぁ!?低いよなぁ!?(^ω^) pic.twitter.com/LuRLIEFet5
お母さん食堂
今日はAndroidアプリ
— sakura (@818uuu) 2020年2月18日
「お母さん食堂」を作りました🍳
右上メニューをクリックして
昼・夜から自分が作ったことのある料理を選択できます。
ホームアイコンも設置しました🏠
イラストや写真は自家製です📷✨
(写真の設定地味に大変)
J( 'ー`)し「たかし、ごはんなにがいいー」 pic.twitter.com/wPBKoFUHD3
血圧測るさん
昨日今日はAndroidアプリ
— sakura (@818uuu) 2020年2月20日
「血圧測るさん」を作りました💉
血圧脈拍の記録・データの変更・削除ができます✍
実装中の出来事
・varとval書き間違え
・ライブラリがimportされてない
・無限アプリ停止
初めてBasic Activity, RecyclerView, Realmを使用しました!(っ ' ᵕ ' c) pic.twitter.com/wdgr1Gg3Na
参考書籍
アプリ開発参考書籍📚 pic.twitter.com/TbNzTwdLdW
— sakura (@818uuu) 2020年2月25日