MOONGIFTニコニコ出張所

読みやすい開発者向けドキュメントとは?

2016/05/13 09:59 投稿

  • タグ:
  • 登録タグはありません
  • タグ:
  • 登録タグはありません

仕様書、ヘルプファイル、Webサービスの開発者向けガイドなど開発者向けにドキュメントを書くことがよくあります。せっかく書いたドキュメントが全く読まれていなかったり、逆に人が書いた文章がとても読みづらく感じることはないでしょうか。

そこで今回は開発者ドキュメントにフォーカスして読みやすくする方法を紹介します。

文体を統一しよう

読みづらい文章で最も多いのが文体の不統一です。ですます、だである文末の違い程度であれば良いのですが、突然へりくだった文章になったり、丁寧な文章になったりするのもよくありません。会話でたとえれば、突然横柄になったり丁寧になったりと態度がころころ変わる人を信用できるでしょうか。

文体を統一するには声に出して読んでみるのが一番です。そうすると突然違和感を感じる部分が出るはずです。

 

ここから先は有料になります

ニコニコポイントで購入する

チャンネルに入会して購読する

  • この記事は過去記事の為、今入会しても読めません。ニコニコポイントでご購入下さい。

コメント

コメントはまだありません
コメントを書き込むにはログインしてください。

いまブロマガで人気の記事

継続入会すると1ヶ月分が無料です。 条件を読む

MOONGIFTチャンネル

MOONGIFTチャンネル

月額
¥550  (税込)
このチャンネルの詳細