文書作成に関するuenopのブックマーク (2)

  • http://oalp.org/doc/writing/

    For full functionality of this site it is necessary to enable JavaScript. Here are the instructions how to enable JavaScript in your web browser.

  • 技術文書を書くための7つのルール

    技術文書を書くための7つのルール¶ さまざまな面から見て、良いドキュメントを書くことは、良いコードを書くよりも簡単です。多くの開発者はドキュメントを書くのはとても難しいことであると考えていますが、いくつかのシンプルなルールに従うだけで、当に簡単になります。 ここでお話しするのは、ポエムのを書くための方法ではなく、プログラムの設計やAPI、コードベースを作り上げる上で、必要となるものを理解するための包括的なテキストを書くための方法になります。 全ての開発者はそのようなテキストを書くことができます。節ではあらゆる場面で適用できる7つのルールを提供します。 2つのステップで書く: まずはアイディアにフォーカスし、その後レビューを行ってテキストの形を整えます。 読者のターゲットを明確にする: それを読むのはだれですか? シンプルなスタイルを使用する: 分かり易くシンプルに保ちます。正しい文法

  • 1