先日、涼もうと窓を開けてギョッとした。窓の桟(さん)があまりにも汚かったのだ。 家を建てて3年ほど経つが、そういえば一度も桟を掃除していない。 ここまで汚れが蓄積していると、掃除をするのもなかなか億劫だ。
「ソフトウェアの「詳細設計書」とはなんなのか」というブログ記事を読んで考えたこと。設計に関するプロセスとドキュメンテーションの関係性についての考えの整理。SI屋的な視点で。 2024/8/18追記:文中にあった雑な文系disが不愉快というご指摘を受けました。ご指摘の通りだと思いましたので訂正しています。大変失礼しました。 「詳細設計書」とはなんなのか nowokay.hatenablog.com こちらの記事では詳細設計書とは以下のようなものであると整理されている。 表現を変えたコーディング(の一種) 机上プロトタイプ(の一種) 分析資料 保守(のための)資料 (水平作業の場合の)作業指示書 (委託している場合の)契約資料 上記以外で考えられるのは次のようなものがあるだろう 利害関係者が要求している たとえば受託開発において発注者が要求している場合 ほかには連携している相手先システム側から
マグ @OnebookofMAG 10代の頃に教わった「主語を抜き、理由を省き、具体例を考えない”言語化をサボる人”は信用しない方がいい」という言葉、そっくりそのまま私の信念に変えて大事にしている。こういう人と仕事をすると「生産的な議論」ができない。「話せばわかる」が成立しない。何より、コミュニケーションコストが高い マグ @OnebookofMAG ちなみに「言語化をサボる人」は、テキストコミュニケーションで顕著にでる。SlackやLINE然り、プライベート感は行間の想像を楽しむコミュニケーションでいいけど、ビジネス面では「察して」は独りよがりかつ、わがままの押し付け。文章を書くのは大変だけど、行間を正しく読むのはもっと大変。 x.com/OnebookofMAG/s… マグ @OnebookofMAG 令和の”人当たりの良さ/コミュニケーションの上手さ”は、電話口や対面で出るものではな
私の愛しいアップルパイへ 8月16日(金)、このTCP/IP網の片隅に新規サービスを産み落としました。「TaskChute Cloud 2」っていいます。 頑張って作ったトップページ去年の8月から本格的に作り始めて、1年間でようやく形になりました。これこそ"俺が考える最強のタスク管理・時間管理サービス"って感じです。 正直タスク管理サービスって有名どころは出尽くしてる感じですし、「いまさらー?」って感じだと思います。この手のサービスは西海岸からいくつも出てますし。 でも、今までの発想のタスク管理サービスって使いづらくないですか?もう実際の仕事に通用しなくないですか?って気持ちもあって、ちょっと違ったアプローチのサービスをガチで作ってみました。 そこそこ借金して1年かけて作りました小学生時代からの友人と作った役員2人だけの極東の極小の会社なんですけど、コロナとか異常な円安とかの影響もあって経
ベイジに入社する前、予備校で講師として小論文やエッセイの書き方を教えていた。入試を突破する文章を書くには、ロジカルシンキングをベースとした文章の作法を身につける必要がある。 初め、高校生や中学生相手にこれを教えるのにはかなり苦戦した。そもそもロジカルとはどういうことかを正確に理解してもらうのに時間がかかる。そして理解できたとしても、少し抽象度を上げたテーマになるとすぐに破綻が起こるのだ。 そんな経験を踏まえて、ロジカルシンキングを身につけるのに効果的だった練習方法を紹介したい。 Step 1:主張(結論)と理由を「なぜなら」でつなぐことを徹底する その年の一番最初の授業で次のルールを設けた。 「今からあなたたちが喋れるのは二文のみ」 「これから私が投げかける質問に対して、一言目で意見を自由に言っていい」 「二言目は必ず『なぜなら』で始まる内容だけを言うこと」 「途中で『なぜなら』にならない
「設計書」というのは、作るものの構造を抽象的に表現したものと言うことができます。 ただ、ソフトウェアの抽象化の仕組みはプログラミングコード自体に備わっているので、ソフトウェア生成可能な抽象的表現というのはコード表現ができるはずですね。コードで表現しておくと、整合性のチェックとかも行いやすいです。 でも、コードではない「詳細設計書」というものが一部業界には必要とされているので、その「詳細設計書」というのは実際はなんなのか考えてみます。 ※ 最初はタイトルは「設計書」としてましたが、話を限定するため「詳細設計書」に変更しました。 追記:納品物に関する記述を追加しました。 表現を変えたコーディング ソフトウェア生成可能な抽象的表現というのはコード表現ができるわけですが、文字で表記する必要もなく、ダイアグラムで表現することもできますね。 代表的なのがER図やクラス図で、これは文字表現との相互変換が
人は年を取るとしわが増えたり、体の節々に痛みを感じたり、突然体の具合がよくなくなったりすることで老いを実感します。スタンフォード大学の研究チームが、「人間は一定の割合で徐々に老いるのではなく、人生で急激に老化が進むポイントが2回存在する」という研究結果を発表しました。 Nonlinear dynamics of multi-omics profiles during human aging | Nature Aging https://www.nature.com/articles/s43587-024-00692-2 Scientists find humans age dramatically in two bursts – at 44, then 60 | Medical research | The Guardian https://www.theguardian.com/scie
こんにちは、リファクタリング大好きなミノ駆動です。 2024/07/20に発売された『ドメイン駆動設計をはじめよう ―ソフトウェアの実装と事業戦略を結びつける実践技法』を、訳者の増田亨氏よりご恵贈賜りました。 この記事は、この書籍の感想です。 著者の許可を得た上でのだいたんな意訳総評等の前にいの一番で伝えたいポイントです。 エリック・エヴァンス氏の『ドメイン駆動設計』は大変価値の高い知見が網羅されている一方、「ユビキタス言語」や「境界づけられたコンテキスト」といった独特の用語が登場したり、難しい言い回しをしていたり、読解がかなり難しい書籍です。 独自用語が登場するたびに「ユビキタス言語?なんだこれ?」とつまづきを覚え、内容理解に集中できず、読む手が止まってしまったことがある人も少なくないのではないでしょうか。 本書『ドメイン駆動設計をはじめよう』は『Learning Domain-Driv
カケハシのプラットフォームチームでソフトウェアエンジニアをしているすてにゃん (id:stefafafan) です。今回はチームに配属されて数ヶ月の私が、いかにして社内ドキュメンテーションの階層構造を整理し、情報の検索性を向上させたかについてお話します。 はじめに この記事の想定読者 課題意識 メンバーへの共有と相談 社外事例の調査 esa の階層整理 第 1・第 2 階層の整理 ストック情報とフロー情報を意識した階層の整理 esa の機能をフル活用する 効果や今後について はじめに カケハシでは全社的にドキュメンテーションツールとして esa - 自律的なチームのための情報共有サービス を利用しています。それぞれのチームやプロダクトごとに階層を切ってドキュメントを書いています。 プラットフォームチームでは認証基盤などの社内プラットフォームシステムを開発しているため、自チームが運用する各種
生成AIをよりよくする手法の一つにRAG = Retrieval-Augmented Generationがあります。これは単純な仕組みから作ることができて、効果的で面白いです。そして、Cloudflare Workersを中心としたCloudflareスタックで実現できます。やってみると、Cloudflareを使ったアプリケーション作成に必要なエッセンスをいくつも体験できることが分かりました。そこ今回は、シンプルなRAGアプリを作りつつ、Cloudflareスタックを学んでみましょう。 リポジトリ 今回扱うコードや関連する例は以下のリポジトリでみれます。 CloudflareスタックでRAGを作るとは? RAGの実装方法を説明します。いくつかありますが、簡単な方法にします。 LLMと会話をするにはsystem、userというロールで以下のようなパラメータを渡します。 app.get('/
著者Pranay Parab - Lifehacker US [原文]翻訳長谷睦(ガリレオ) 2024.08.08 lastupdate 複数のApple製デバイスをまたいでメモを取る際に、私はAppleの「メモ」アプリを愛用しています。 iPhone版の「メモ」アプリも愛用していますが、Mac版ではさらに多くの機能が使えます。たとえば、Markdownを使う、デスクトップから直接メモの内容を検索する、といったことです。それらを可能にするのが、サードパーティアプリの「ProNotes」です。 ProNotesは単体で使うものではなく、「メモ」アプリの機能拡張として働き、パワーユーザー待望の機能を追加してくれるアプリです。 この追加機能が本当に優秀で、これを入れれば、「メモ」アプリが本格的な文書作成ソフトになる、と言えるほどです。 では、その具体的な機能をご紹介しましょう。 検索を容易にする
RAGの精度改善するために何があるかを学びました。基本系のNaive RAGを知っている人向けの記事です。 方法が多すぎるので、Youtubeの「RAG From Scratch」を中心に少し整理してみました。LangChainをよく使っているので、LangChain出典が多いです。 全体像 まずは、RAGの全体像。Indexingが同じ流れにあるのが少しわかりにくいのですが、実行タイミングとしてはRAGの前準備としてやっておきます。 画像出典: RAG from scratch: Overview もう少し粒度を細かくした図です。 画像出典: RAG from scratch: Overview 表形式で分類します。Generationだけ少し特殊です。 大分類 中分類 内容
こんにちは。 jQuery から商業プログラミングに入門したやまゆです。 なぜ jQuery だと古い、ダメだと言われるのでしょうか?いいじゃん。 $.ajax で簡単にデータ引っ張ってこれるし、 $("#btn").click(function () { alert("押した!"); }); は誰が見ても何が起こるか一瞬で分かる Simple さがあるじゃん。なんでわざわざ React/Vue/Svelte その他 jQuery ではないライブラリを使わなければならないんでしょうか? 100 億回言われてきたことだと思いますが、私なりに振り返ってみます。 手続き型 UI と宣言型 UI は、手続き型です。 btn という ID の DOM 要素を取得して、それらの(一応複数になる可能性があります)要素に対して click イベントハンドラを登録します。 この処理が実行される前と後では、
1. 事の発端 それは昨年2023年の秋頃。いつものように新潟県立歴史博物館開催の企画展の内覧会に行ったところ、とある学芸員さんに「ちょっと話が……」と別室(食堂兼フリースペース)に通されました。「え、私たちなんかやっちゃいました……?(心当たりがありすぎる)」とビビっていたら「売店を運営しない?」という予想外の話が飛び出てきたのでした。 ちなみに歴博(新潟県立歴史博物館)の売店は昨年2023年3月26日で閉店しています。 ミュージアムショップ「柏屋」閉店のお知らせ(3/26までの営業) | 新潟県立歴史博物館公式サイト http://nbz.or.jp/?p=28796 このときの話は 売店の運営期間は4月20日から6月9日までの春の企画展期間だけ。(でも、やる気があるならそのあとも入ってもらってかまわない。) 販売する商品は委託販売の形で提供される。それとは別に自分たちで仕入れたものを
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く