mazinlabsのｱﾝﾃﾅ - はてなｱﾝﾃﾅ

▽ﾌﾟﾛｸﾞﾗﾏｰの脳みそ
●12/04 00:29 Nagise
2024-12-01推敲のﾛｼﾞｯｸ技術記事とかを書くとき､推敲をする｡僕がどういうﾛｼﾞｯｸで推敲をしているかの話｡前提知識想定読者をまず決める｡この記事を読むには前提知識としてこのぐらいは知っていてね､のﾗｲﾝ｡例えばJavaの記事を書くなら基礎的な構文は分かってる前提とする､とか､ﾏﾆｱｯｸな記事なら､もっと深い知識を持っている前提とする､とか｡一般向けの記事だと高校までで習うような前提知識があれば良いとするとかとか｡これは､前提知識の部分なら解説なしに｢知ってるよね｣の前提で話をする｡知ってるかどうか危うい時はちょっと注釈をつける｡知らない想定の部分は丁寧に解説をする｡そのﾗｲﾝを決めるのが想定読者の前提知識｡知識は前提知識の上に積みあがる｡積み重ねていく積み木のようなもので､この記事は既にここまで積んである人に対して､追加で何個の積み木を積ませよう､みたいな目標を定める｡