有用な文書を作るために心掛けたいこと この記事は rogy Advent Calendar 2018 の21日目の記事 (#LATECH) です。 前日の記事は STM32でマウスとキーボードを作る – 東京工業大学 ロボット技術研究会公式ブログ でした。 文書を“作る” この記事を読む皆様は、少なからず日頃から文章を書くことがあるかと思います。 文章を書き公開しようというとき、「良い文章の書き方」はいろいろなところで目にしますし、必要とあらば勉強することもあるでしょう。 しかし、文章そのものではなく「良い文書の作り方」を意識したことはありますか? どんなに良い文章であっても、駄目な性質を多く持つ文書として公開されると、その価値は暴落します[0]。 本記事では、内容はさておき「良い文書」を作ろうというとき私が心掛けていることなどを紹介します。 良い文書とは 私の考える良い文書とは何なのか、
![有用なドキュメントを作るために心掛けたいこと](https://cdn-ak-scissors.b.st-hatena.com/image/square/1c419c1c1fa0f9fbc3719f1e7799719f1ceaad06/height=288;version=1;width=512/https%3A%2F%2Fblog.cardina1.red%2Fassets%2Fimg%2Fprofiles%2Ficon%2Flo48576.mastodon.cardina1.red.2017-10-15.jpg)