![DDDBE #12 - ReactJS / Flux](https://cdn-ak-scissors.b.st-hatena.com/image/square/78201b952db396ca0c6f42c4fd779aaf6eee9401/height=288;version=1;width=512/https%3A%2F%2Fi.ytimg.com%2Fvi%2FQSiTtFWuhZE%2Fhqdefault.jpg)
技術文書を書くための7つのルール¶ さまざまな面から見て、良いドキュメントを書くことは、良いコードを書くよりも簡単です。多くの開発者はドキュメントを書くのはとても難しいことであると考えていますが、いくつかのシンプルなルールに従うだけで、本当に簡単になります。 ここでお話しするのは、ポエムの本を書くための方法ではなく、プログラムの設計やAPI、コードベースを作り上げる上で、必要となるものを理解するための包括的なテキストを書くための方法になります。 全ての開発者はそのようなテキストを書くことができます。本節ではあらゆる場面で適用できる7つのルールを提供します。 2つのステップで書く: まずはアイディアにフォーカスし、その後レビューを行ってテキストの形を整えます。 読者のターゲットを明確にする: それを読むのはだれですか? シンプルなスタイルを使用する: 分かり易くシンプルに保ちます。正しい文法
Yeah, it's kind of time. I have to admit it. It's time to wrap things up. SimpleDiagrams is no more. A lot of people have used SimpleD over the years. Dare I say some even found it nice. But the time has come to move on to new things. It's OK! It's ok. I'm not bitter. No no. Not bitter at all. It was all good fun to make. And if I learned one thing, it's that customer service is the best part of t
Sick of boring JavaScript newsletters?Bytes is a JavaScript newsletter you'll actually enjoy reading. Delivered every Monday, for free.
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く