[B! document] unaristのブックマーク

プロダクトマネージャーの必須スキル: デザインドックの書き方 - Design Doc｜kosuke mori

私 (@kossmori) が働くアメリカのスタートアップでは、どんな会話においても ”Is there a design doc?” (デザインドックはないの?) という質問が連発します。会話のコンテクストを合わせるため、取り組みの背景を理解するための必須資料として位置づけられています。デザインドックは技術詳細を書いた仕様書ではありません。取組みに関わる Why, What, How と、ハイレベルな実装戦略、主要な設計上の決定、決定の際に考慮されたトレードオフに重点を置いて文書化したもので、それをもとにエンジニアは必要に応じてTech docを書き、デザイナーはデザインを始めます。追記: その2も書きました。最後の方に記事へのリンクを貼っています。追追記: 思った以上に反響あり、この記事のおかげでこれまで非常に多くのスタートアップの方々とお話しさせていただく機会をいただき

unarist 2022/06/24

リンク

An update on MDN Web Docs’ localization strategy – Mozilla Hacks - the Web developer blog

In our previous post — MDN Web Docs evolves! Lowdown on the upcoming new platform — we talked about many aspects of the new MDN Web Docs platform that we’re launching on December 14th. In this post, we’ll look at one aspect in more detail — how we are handling localization going forward. We’ll talk about how our thinking has changed since our previous post, and detail our updated course of action.

unarist 2020/12/20

document

リンク

Welcome Yari: MDN Web Docs has a new platform – Mozilla Hacks - the Web developer blog

After several intense months of work on such a significant change, the day is finally upon us: MDN Web Docs’ new platform (codenamed Yari) is finally launched! Between November 2 and December 14, we ran a beta period in which a number of our fabulous community members tested out the new platform, submitted content changes, allowed us to try out the new contribution workflow, and suggested improvem

unarist 2020/12/20

document

リンク

アーキテクチャの「なぜ？」を記録する！ADRってなんぞや？ - Qiita

5月のThoughtWorksのTechno logy RadarでもADOPTされたADRという手法について、面白かったので、ざっくり自分なりに調べたメモです。 Techno logy Radarでは以下のように述べられています。多くのドキュメントは、読みやすいコードとテストに置き換えることができます。しかし、進化的アーキテクチャでは、将来のチームメンバーの利益と外部の監督のために、特定の設計上の決定を記録することが重要です。Lightweight Architecture Decision Recordsは、重要なアーキテクチャー決定を、そのコンテキストおよび結果と共に取り込むための技法です。これらの詳細は、WikiやWebサイトではなくソース管理に格納することをお勧めします。そうすれば、コードと同期したままのレコードを提供できるからです。ほとんどのプロジェクトでは、この手法を使いたくな