タグ

2021年10月18日のブックマーク (7件)

  • 却下できる人が承認することに意味がある - 余白

    コードレビューに限らず、いろいろなレビューがいろいろなプロセスに組み込まれている。 だが、レビューにおいて、たとえ内容に瑕疵があっても承認されるなら、そのレビューは単なる形式・儀式に過ぎない。 "何かを保障するためのプロセス"としてのレビューを機能させることを目的とするなら、そこには却下の可能性があることが必要条件だ。 保障: ある状態がそこなわれることのないように、保護し守ること。(https://kotobank.jp/word/%E4%BF%9D%E9%9A%9C-630029) 却下と批判的立場 そのようなレビューにおいて、レビュアーは「これは承認しても大丈夫か」と思考する。 「承認しても大丈夫だ」という確信を得るということは、裏返せば「却下すべき理由がない」という確信を得ることである。 その確信が得られるのは「却下すべき理由を探したが見つからなかった」ときである。 つまりレビュア

    却下できる人が承認することに意味がある - 余白
  • サラダチキンと炒めたパン粉で「ソースチキンカツ風丼」がサクッとサクサクにできてしまう - メシ通 | ホットペッパーグルメ

    こんにちは、高円寺メタルめしのヤスナリオです。 市販のサラダチキンで手軽に作るご飯ものシリーズ、 www.hotpepper.jp www.hotpepper.jp 今回は、サラダチキンと炒めたパン粉でできちゃう「ソースチキンカツ風丼」です。 ご飯にサラダチキンとせん切りキャベツをのっけて、炒めたパン粉をふりかけたら、あとはソースをかけるだけのスピードレシピ。ですが、これをひと口頬張ればソースのかかったチキンカツ丼のあの味なんです。 油も少ししか使わないので、サラダチキンのヘルシーさもキープ。「このパン粉、そろそろ使い切ったほうがいいかも」っていうときの、パン粉消費レシピにもオススメですよ。 ヤスナリオの「ソースチキンカツ風丼」 材料:1人分 サラダチキン(市販品、プレーン) 1個 パン粉(乾燥タイプ) 1カップ(45g程度) サラダ油 大さじ1 温かいご飯 1人分 せん切りキャベツ(市販

    サラダチキンと炒めたパン粉で「ソースチキンカツ風丼」がサクッとサクサクにできてしまう - メシ通 | ホットペッパーグルメ
  • Netflixにおける実用的なAPI設計: gRPCとFieldMask | pyspa

    Netflix Tech BlogのgRPC APIに関する以下の2つの記事に感銘を受けたので、ここにその概要を日語で記します。 (めんどくさかったので)翻訳の許可は取ってませんが、再構成してますし元のJavaではなくPythonで書き直していますので、容赦して下さい… Practical API Design at Netflix, Part 1: Using Protobuf FieldMaskPractical API Design at Netflix, Part 2: Protobuf FieldMask for Mutation OperationsまとめgRPCでは、FieldMaskをうまく使うことで、必要な情報だけ取得したりあるいは与えたりしたりできまっせ第一部まずField Maskをどのように使うかを述べています。 背景Remote Callというものは、そもそもコ

    Netflixにおける実用的なAPI設計: gRPCとFieldMask | pyspa
  • ドキュメント駆動開発v2

    前提 ここで言っているドキュメントは仕様書ではなく、顧客向け製品ドキュメント。 ミドルウェア製品を開発 小さなチーム パッケージ製品とパッケージ製品のクラウド版 そのため顧客に提供するドキュメントが必ず必要 GitHub を利用 自分で開発する場合のフロー 作りたい機能をぼんやりでいいので GitHub Issue に追加する feature ブランチを切る デザインドキュメントをリポジトリの doc/ 以下に書く デザインドキュメントに合わせてコーディングを進めてなんとなく動くところまで作る 動かなくてもいいのでイメージを膨らませるためにコードを書いてみる デザインドキュメントは書き捨て前提で、とにかくメモを書く 製品ドキュメントを書き始めて、一旦書き終える ブランチマージに向けてコーディングを進める 書ける範囲でテストを書く ドキュメントを平行して修正する プルリクエストをだしてレビュ

    ドキュメント駆動開発v2
  • スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ|Anno Takahiro

    ドキュメント文化は健全な組織のスケールのために必要 組織の中でドキュメント/文章を残し活用していくことはとても重要だ。クオリティの高いドキュメントがあることで、組織に情報が流通し、透明性を確保できるようになる。情報を流通させるためにいちいち口頭の説明がいらないから、メンバーの数が増えた時でもスケールしやすくなる。過去の結論にアクセス可能になるので、議論を積み上げていき、意思決定のクオリティを高めることにもつながる。そもそも何かを読むということは何かを聞いて教わるよりも時間あたりの処理量が多いし、非同期に実施できる。良いドキュメントをアセットとして社内に蓄積していくことはスタートアップのみならず、ありとあらゆる組織が成長していく上でとても重要であると言える。 しかしその一方で、良質なドキュメント文化を徹底できている会社は多くないように見える。例えば、社内のドキュメントを蓄積させていく場所とし

    スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ|Anno Takahiro
  • 技術を食い物にした話 | Natural Days

    そういえば、書いてなかったな…と思って、残しておくことにする。 よく開発・プロダクトにして売買するの凄い、という話があったりするけど、お金に還元されないと価値は無いのか?というと、もちろんそうでは無いですよね。お金にするという選択もあり、それ以外の方法もある(技術い物にする)という事を少しばかり。 ■ モノと経緯 数年前にRealSenseの変換アダプタを制作した。 Intel RealSense USB 3.0 original board TMCN USB 3.0変換ボードと書いてある通り、コミュニティと人の繋がりで出来た物だった。USB 3.0の導体をひっぱり出して、検証した内容はこちら。 TMCN Intel RealSense USB 3.0 original board elecrowで作って動作確認・公開したところ、色んな国・人からのコメントや「欲しい」というリクエストが

    技術を食い物にした話 | Natural Days
    Tomato-360
    Tomato-360 2021/10/18
    おもしろい
  • GitLab的ドキュメント文化を組織にインストールする(実践編:スタートアップMNTSQの事例)|Anno Takahiro

    会社組織にドキュメント文化をインストールすることの有用性や、GitLabのような企業がどのようにドキュメントを運用しているかを、前回記事で書いた(スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ)。今回は、私のいるスタートアップのMNTSQ(モンテスキュー、と読みます)でどのようにそれを実践しているか、実際のところどのような成果が出ているのかについて書いてみたい。 MNTSQでは、当初からドキュメンテーションの重要性を経営メンバー全員で認識しており、社内ドキュメントをGitHub管理でメンテナンスしながら作り上げていくようにしていた。この大枠の仕組みの設計部分は弊社のデザイナーの生谷(@ikutani41)が初期に考案/メンテしたものである。デザイナー視点からこのような仕組みが設計され稼働されることは珍しいと思う。この辺については人からもどう

    GitLab的ドキュメント文化を組織にインストールする(実践編:スタートアップMNTSQの事例)|Anno Takahiro
    Tomato-360
    Tomato-360 2021/10/18
    ドキュメント文化大事だよな。どこかに集約されていてそこを見れれば良くてインテグレーションが充実しているところがよい。