ドキュメントに固執せよ - gfnweb
どうして人間集団はこんなにも知見の共有を円滑にできないのか？ 改善にはドキュメントにまつわる各個人の心構え・制度設計・技術的解決の全部が必要だという話をしたい． ここでテーマにしているのは，著名OSSなど世の中にいくらでも知見が転がっている対象ではなく，特に企業内の十数人のチームでクローズドに開発しているなどして集合知に頼れない状況下でのドキュメントについてである． 非常に乱暴な言い方をするなら，「コードとか大部分は誰でも書けるようになるものなんよ，そんなところにマッチョイズムとか感じなくてええねん，我々の知的体力や組織性が真に試されるのはドキュメントちゃうんか」という気持ちです — 画力・博士号・油田 (@bd_gfngfn) June 3, 2022 ドキュメントに書く内容の必須項目或るシステム（ソフトウェアなど）について，そのシステムのことを全く知らない人を想定読者としたドキュメント
「ブラック校則」の「合理的理由」をしつこく問い詰める - 紙屋研究所
福岡市の中学校の人権侵害の校則、いわゆる「ブラック校則」が話題になっている。 news.livedoor.com 「学校まかせ」では人権侵害がいつまでも解決しない ぼくは市内の中学校に娘を通わせる一人の親として強い関心を持ってきた。 ぼくがずっと感じている不満は、「校則は学校ごとの問題。学校ごとに決めればいい」という扱いをされることだ。結果的にいつまでたっても問題が解決しないのである。 学校という単位になると、一人の保護者が言えることは実に限られている。担任や校長に話したこともある。それで変わるかどうかはわからない。というか、悪意にとらえれば、「３年間、のらりくらりとかわしていれば、このモンペは子どもが卒業してしまうのでおさらばだ」と思われているのだろう。 PTAを通じた改革の可能性と難しさ PTAはどうか。福岡市でもPTAを通じて改革したケースはある。 news.yahoo.co.jp
優秀さについて
Twitter で医師を拾ってきて Google のソフトウェアエンジニアにするだけの簡単なお仕事 - 白のカピバラの逆極限 S.144-3 はじめに 「【転職エントリ】Googleに入社します｜Lillian｜note」という、医師から未経験で Google のソフトウェアエンジニアになった記事があります。 note.com 私は、この記事に出てくる「とある元 Google のソフトウェアエンジニア」で、面接の対策を立てました。 記事が出た当初から大反響で、私もそれなりの反応を見まして、いろいろと誤解されているなあ、と思う一方、アドバイザーはあくまでもアドバイザーだから、アドバイザーとして知りえた情報については、口をつぐむべきだと思っていました。 ただ、あまりにも誤解されており、悪影響が大きく、犠牲者も多くなってきたと思ったので、… 同僚からこれについてどう思うか、と聞かれた。元の文章が
pipとpipenvとpoetryの技術的・歴史的背景とその展望 - Stimulator
- はじめに - Pythonのパッケージ管理ツールは、長らく乱世にあると言える。 特にpip、pipenv、poetryというツールの登場シーン前後では、多くの変革がもたらされた。 本記事は、Pythonパッケージ管理ツールであるpip、pipenv、poetryの3つに着目し、それぞれのツールに対してフラットな背景、技術的な説明を示しながら、所属企業内にてpoetry移行大臣として1年活動した上での経験、移行の意図について綴り、今後のPythonパッケージ管理の展望について妄想するものである。 注意：本記事はPythonパッケージ管理のベストプラクティスを主張する記事ではありません。背景を理解し自らの開発環境や状態に応じて適切に技術選定できるソフトウェアエンジニアこそ良いソフトウェアエンジニアであると筆者は考えています。 重要なポイントのみ把握したい場合は、各章の最後のまとめを読んで頂
差別的世界の歩き方｜雨滴堂=Utekido=
その数学の先生は、日本人が嫌いなようだった。はっきりとはそう言わなかったが、たかだか14歳のわたしでも、歓迎されていないことは感じていた。 彼はいい歳だったが振る舞いは幼く、「日本人は九九がインストールされているんだから電卓要らないだろ」と言ってわたしから取り上げてみたり、わたしが答えを間違えると、「トヨダが数学間違えることなんてあるんだな。いや、君はホンダだったっけ？」と戯けてみたりしていた。わたしは辟易していたが、クラスのほとんどの子は「くだらなーい」と大げさに嘆く素振りをしつつも、彼の冗談に好意的だった。わたしの成績は、段々落ちていった。 考えて導き出した答えが正しければ「日本人だからできて当たり前」と評され、間違っていればここぞとばかりに先生が悪ふざけをする。そして「英語が下手だから」という理由で、100点を取ったところで成績はいつもBマイナス。数学の時間、わたしは授業に参加するの
生きていても 死んでいるのと同じ | NHKニュース
浜辺に流れ着く遺体。 その男性は、これまでに400人以上の墓を作って埋葬していました。 「生きていても、死んでいるのと同じだから」 墓を見つめながら、男性は、こう漏らしました。（国際部記者 スレイマン・アーデル）
COCOA騒動メモ
COCOA が動いていなかったことで大臣が謝罪してひと騒動起きている件について、開発者視点からのメモを残してみます。 なぜこのメモを書いたのか 世間的には不正確な情報で叩ければOKの風潮が強くてしんどいので、正しいと思われる情報を拾い集めたものです。中抜きwww 王子wwwww Xamarin wwwwwwww みたいな人にはあんまり興味ないかと思います。 調べ始めたきっかけはこのツイートと引用されたblog記事ですが、記事の内容が違うことはすぐに指摘されて撤回されていたのですが、実際どうだったのかさらに調べてみました。 接触通知アプリ COCOA とはなんなのか 仕組みとか何かは公式サイトでもみてもらうとして。この件で煽っている人でも一部理解できていない人がいるようなのですが、直接的な効果としては 保健所が濃厚接触者追跡をする際の手助けとなるためのアプリ ということになります。アプリをイ
質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
