タグ

ブックマーク / blog.magnolia.tech (60)

  • 『読み手につたわる文章 - テクニカルライティング』を読んで、レビューテクニックを身につけよう! - Magnolia Tech

    booth.pm mochikoさんが書かれた『読み手につたわる文章 - テクニカルライティング』というを読みました。 このはビジネスの現場で必要な「相手に伝えたいことを正しく伝える」ためのテクニックが詰まったです。 大事なことがコンパクトに詰まっていて、何度も読み返したり、他の人に紹介するのに適しています。この辺はどうしても商業出版だと一定のページ数が無いと出版が難しいので、同人誌として出版するのに向いている構成ですね。 いくつか「そうだよねー」と思ったトピックを拾っておくと... 読者層を決めてから書こう 自分も何らかの文書を書く時は、「誰が読むのか?」というのを常に一番考えて書いています。特に、特定の読み手が想定できる報告書などの文書は、まずはどこまで相手の理解度を前提条件として想定できるか?ということを考えます。不特定多数の人向けの文書では難しいですが、特定の人向け、特に直接

    『読み手につたわる文章 - テクニカルライティング』を読んで、レビューテクニックを身につけよう! - Magnolia Tech
  • 『ドメイン駆動設計をはじめよう ―ソフトウェアの実装と事業戦略を結びつける実践技法』が出版されます - Magnolia Tech

    ドメイン駆動設計をはじめよう ―ソフトウェアの実装と事業戦略を結びつける実践技法 作者:Vlad KhononovオライリージャパンAmazon 2021年にO'Reilly Media, Inc.から出版された「Learning Domain-Driven Design」の待望の日語訳『ドメイン駆動設計をはじめよう ―ソフトウェアの実装と事業戦略を結びつける実践技法』がついに出版されます。 www.oreilly.com 訳者は、増田 亨さん!! 2020年代に、ドメイン駆動設計を学ぶための最初の入り口としてどのを読めば良いかは、かなり悩ましい...というのはよく言われるのですが(元祖のエバンスはさすがにだいぶ古くなってきたし、回りくどい表現も多いし...)、そんな時におすすめできる1冊です。 2021年に原著が出版された時に買ってざっと読んでいたのですが、パート1で戦略的DDD(

    『ドメイン駆動設計をはじめよう ―ソフトウェアの実装と事業戦略を結びつける実践技法』が出版されます - Magnolia Tech
  • 『WEB+DB PRESS総集編[Vol.1~136]』でWebアプリケーション開発の歴史を振り返る - Magnolia Tech

    WEB+DB PRESS総集編[Vol.1~136] (WEB+DB PRESS plusシリーズ) 技術評論社Amazon 22年間続いたWEB+DB Pressが休刊になる、というニュースは衝撃でした。 gihyo.jp 初めて買ったのがいつだったのか全然覚えていないのですが、PerlRubyをはじめとするLL言語(そんな言い方もしなくなりましたね)を勉強するために買い始めた記憶があります。 一度だけ記事を書かさせて頂いたこともありますが、わずかなページ数を書き上げるのに、こんな大変な思いをしてみんな書いているのか、編集者の方はこんな的確な指摘をしてくれるのか、と色々な発見が有りました。 残念ながら昨年行われた22.9周年パーティには参加できなかったのですが、写真からだけでも関わった方々の熱気が分かりますね。 blog.kushii.net ある意味で「幼年期の終わり」を迎えた業界で

    『WEB+DB PRESS総集編[Vol.1~136]』でWebアプリケーション開発の歴史を振り返る - Magnolia Tech
  • 『データモデリングでドメインを駆動する ――分散/疎結合な基幹系システムに向けて』”基幹システム”とは何か、どう作るのか、ということへの道標を示してくれる1冊 - Magnolia Tech

    データモデリングでドメインを駆動する──分散/疎結合な基幹系システムに向けて 作者:杉技術評論社Amazon 著者の杉啓様より献いただきました。 「基幹システム」……よく考えると最近だんだんと聞く機会の減ってきたキーワードです。たまにメインフレーム上で動くCOBOLで組まれた基幹システムが負債になっている、といった比較的後ろ向きな話題の文脈で出てきて、あまり「攻めた」話題の文脈では出てこないイメージがあります。 書は、この「そもそも基幹システムとは何か?」、その基幹システムの中心にある「帳簿」とはどんな役割を果たすのか?それらを支える「データモデル」はどのようなもので、どのような設計になるのか?といったことが、長年経営管理システムを作ってきた経験に裏打ちされた知識をもとに分かりやすく解説されます。 この手の、業務システムの設計の考え方、「要件に沿って設計する」以上の解説がなかな

    『データモデリングでドメインを駆動する ――分散/疎結合な基幹系システムに向けて』”基幹システム”とは何か、どう作るのか、ということへの道標を示してくれる1冊 - Magnolia Tech
  • YAPC::Hiroshima 2024へオンライン参加した - Magnolia Tech

    yapcjapan.org さすがに、オンライン参加だと一日中PCの前に張り付いて発表を聞き続ける、というのができないので、断片的にいくつかのトークやLTを聴いた 中でも「平成のエンジニアから令和のエンジニアへの遺言〜技術情報を伝達する手段の変遷〜」と、杜甫々さんのキーノートが良かった 40歳を超えると健康の話しかしなくなるw#yapcjapan— magnoliak🍧 (@magnolia_k_) February 10, 2024 マジで伝説の人だ… とほほでHTMLCSS学びました… #yapcjapan pic.twitter.com/XuqYoJ9PUA— Sotaro Karasawa🍺 (@sotarok) February 10, 2024 きっと後日ビデオが公開されると思うので、ぜひ見て欲しい、としか言えないのだけど、YAPCが毎年ちゃんと開催されていることが当に

    YAPC::Hiroshima 2024へオンライン参加した - Magnolia Tech
  • 技術書の積読を避けるためにやっていること - Magnolia Tech

    ついつい技術書を買いすぎて、なかなか読めないまま次を買ってしまったりして、結局読まないままになる、というパターンに時々ハマっている。なるべくそうしないように厳選しているつもりなのだけど、それでもいわゆる積読が発生してしまう。 技術書に関しては、二つのルールを守るようにしている 紙のを買う 電子書籍の方が圧倒的に便利なのは分かっているのだけど、やはり物理的な「圧」が有った方が読もうという気になるので、技術書は可能な限り紙ので買うことにしている 一度に読むを限定する 机の上に無印良品の仕切りスタンドを置いてあって、ここに収まる以外は同時に読まないようにしている 読み終わったら、棚のと入れ替え MUJI 無印良品 スチロール仕切りスタンド・ホワイトグレー 3仕切・大・約270×210×160mm 02856410 MUJIAmazon 無印良品 アクリル仕切りスタンド 3仕切り・約1

    技術書の積読を避けるためにやっていること - Magnolia Tech
  • 『systemdの思想と機能 ―Linuxを支えるシステム管理のためのソフトウェアスイート』でsystemdの機能を再確認する - Magnolia Tech

    systemdの思想と機能 Linuxを支えるシステム管理のためのソフトウェアスイート Software Design plus 作者:森若 和雄技術評論社Amazon いつの間にかどのLinuxディストリビューションでも標準で使われるようになったsystemd。なんとなくsystemctlを叩いてサービスを立ち上げていたけど、いまいち「なんで必要なの?」とか、「いろいろ機能があるっぽいけど、何ができるの?」といったことをちゃんと勉強しないままここまで来てしまったので、このでおさらい。 単なる機能紹介ではなく、「なぜsystemdはこんな広範囲な機能を扱うのか?」という機能が作られた背景から説明されているところがいいですね。 このを読むまでcore dumpまで管理されるようになったことを知りませんでした。 書を読めば、systemdはサービスが動く環境を用意するために必要な機能を備

    『systemdの思想と機能 ―Linuxを支えるシステム管理のためのソフトウェアスイート』でsystemdの機能を再確認する - Magnolia Tech
  • 2023年買ったもの(技術書とか) - Magnolia Tech

    2023年のお買い物、技術書編です。 技術書以外はこちら blog.magnolia.tech とりあえずノータイムで買っちゃえ!損は無いよ!という3冊 他に、類似のがないか、有ってもこっち買っておけばよくね?という3冊 なっとく!関数型プログラミング なっとく!関数型プログラミング 作者:Michał Płachta翔泳社Amazon Scalaをベースとした関数型プログラミングの学習。オブジェクト指向言語であり、関数型プログラミング言語であるScalaの特性を生かして、命令型から宣言型のコードの書き方への変え方を学んでいくスタイル。 前半の凄まじい丁寧な学習のステップと、後半の「ここまで一気にやらなくても良くない?」の落差もすごいけど、ページ数の厚さに躊躇せず、前半1/3くらいを時間をかけて丁寧に学習するくらいが良いと思います。 周りに良い先生が居れば別ですが、そうでなければこの

    2023年買ったもの(技術書とか) - Magnolia Tech
  • 『実践プロパティベーステスト ― PropErとErlang/Elixirではじめよう』は、言語に関係なくプロパティベーステストを学びたい人はすぐ買うべき - Magnolia Tech

    実践プロパティベーステスト ― PropErとErlang/Elixirではじめよう 作者:Fred HebertラムダノートAmazon Erlang/ElixirのPropErというライブラリをベースに、プロパティベーステストの考え方、テストの実践的な書き方を学ぶためのです。 『実践プロパティベーステスト ― PropErとErlang/Elixirではじめよう』www.lambdanote.com 書名だけ見ると「Erlang/Elixirは使ってないからなー」と避けてしまうかもしれませんが、それはもったいなく、言語に関係なく、”プロパティベーステスティング”という手法の質的な活用の仕方が学べるようになっています。 ここしばらくScalaScalaCheckというプロパティベーステストライブラリを使ってテストを書くことに挑戦していたのですが、今一つより良い書き方が分からず、何か

    『実践プロパティベーステスト ― PropErとErlang/Elixirではじめよう』は、言語に関係なくプロパティベーステストを学びたい人はすぐ買うべき - Magnolia Tech
  • Scalaわいわい勉強会へ参加した - Magnolia Tech

    scala-tokyo.connpass.com 最近、圧倒的なScala情報の発信でおなじみの id:Windymelt さんによる主催の「Scalaわいわい勉強会」に参加した。 場所は、「はてな東京オフィス」……1年に1回くらいビルの前を通ることは有っても、コロナ禍が始まってから中に入ることの無かった場所に久しぶりに入ることができた。 久しぶりの、はてな東京オフィスに来た https://t.co/KLKKrO9TCy— magnoliak🍧 (@magnolia_k_) 2023年10月13日 ちょっと遅れて会場に到着、その時点ですでに id:tanishiking24 さんの「Scala Days Madrid レポート」が始まっていた。発表の後も含めて海外Scalaの動向が聞けたのと、ScalaDaysの様子のオシャレ映像が良かった。 tanishiking24.hatena

    Scalaわいわい勉強会へ参加した - Magnolia Tech
  • データモデルをimmutableに設計したいが... - Magnolia Tech

    データ構造をimmutableにしたい、イベントは起きたことをそのまま記録したい、更には監査の観点から修正させたくない、という人類の夢と希望に対して、「だってそれじゃあ現場は回らないんだよ」という例外運用のバランスをどこで取っていくか?というのは昨日・今日出てきた話ではないんですよ— magnoliak🍧 (@magnolia_k_) 2021年11月28日 所謂、業務システムの設計の一番肝心なところって、「起きた事実をありのまま記録する」っていう要件と、実際の運用がそうなっていない現実との戦いなんじゃないかって みんなそうしたいんだよ、でもできないんだよっていう— magnoliak🍧 (@magnolia_k_) 2021年11月28日 「データを活用しよう」って言い出しても、「活用できるように維持していましたっけ?」みたいな話も同じなんだけど、とにかく例外との戦いなんですよ— m

    データモデルをimmutableに設計したいが... - Magnolia Tech
  • 『スクラムの拡張による組織づくり』を読んで、そもそも”組織をつくる”ってなんだろうなって考えた - Magnolia Tech

    スクラムの拡張による組織づくり──複数のスクラムチームをScrum@Scaleで運用する WEB+DB PRESS plus 作者:粕谷 大輔技術評論社Amazon だいくしーさんこと、粕谷大輔さんの『スクラムの拡張による組織づくり』を読みました。 複数のスクラムチームを協業させていく手法として「Scrum@Scale」を軸に、スクラムという概念自体のおさらいから始まり、コミュニケーションを軸とした組織の作り方、運用の仕方を解説していく構成になっています。 第3章で出てくる「毎日45分で問題が解決する」というのはなかなかキャッチーな表現で、Daily Scrum -> Scaled Daily Scrum -> Executive Action Teamのそれぞれに15分という目安を作ることで、議論ではなく問題の確認と決定の場としてショートに実行するものである、という定義が明確で分かりやす

    『スクラムの拡張による組織づくり』を読んで、そもそも”組織をつくる”ってなんだろうなって考えた - Magnolia Tech
  • WEB+DB PRESS Vol.136 最終号!---日本のソフトウェア技術を支えてくれた雑誌の休刊 - Magnolia Tech

    WEB+DB PRESS Vol.136 技術評論社Amazon 表紙に「最終号」と書かれているのが、ちょいと悲しい。 技術雑誌の存在ってなんだろうなと考えてみると、一つ一つの記事の深掘りは当然単行に比べると浅い。でもすべての技術にたいして専用の技術書が出る訳でもない中、ブログ記事などに比べると、編集者の目を通っていることと、一回あたりのページ数が少ない分だけ入りやすいことで重宝する。それに「今、こういう技術が話題になっているんだな」って、ざっと理解できるのも良い。目の前で使わない技術でも、いつか使う日がやってくる時に、「そういえば、ちょっと前に特集されていたなー」と思い出せるだけでも知識のインデックスとして有効に機能してくれる。 そんな雑誌が無くなってしまうのは、けっこう寂しいし、何か大きな穴が空いてしまった感じがする。でもそれを実感するのは今日・明日ではなく、ずっと先のことだと思うけ

    WEB+DB PRESS Vol.136 最終号!---日本のソフトウェア技術を支えてくれた雑誌の休刊 - Magnolia Tech
  • 『なっとく!関数型プログラミング』は読者の理解度の進捗を先読みして作り込まれた”プログラミング入門”の良書 - Magnolia Tech

    なっとく!関数型プログラミング 作者:Michał Płachta翔泳社Amazon 良い、買おう、読もう、(コードを)書こう、以上! めっちゃ良いですよ、この 中盤のプリミティブじゃやりづらい→直積→直和→二つ合わせてADT→値を取り出すためのパターンマッチの解説の流れの疾走感がいいですね— magnoliak🍧 (@magnolia_k_) 2023年8月6日 『なっとく!関数型プログラミング』は、2022年に出版された『Grokking Functional Programming』の邦訳版で、主にScalaを題材として関数型プログラミングを学んでいくための入門書("Grokking"は、完全に理解する、という意味)。あくまで関数型プログラミングの考え方、コードの書き方、良い設計の指針の解説が主眼に置かれているので、Scalaの言語機能の入門書ではない。Scalaの言語仕様を網羅

    『なっとく!関数型プログラミング』は読者の理解度の進捗を先読みして作り込まれた”プログラミング入門”の良書 - Magnolia Tech
  • 『ソフトウェア設計のトレードオフと誤り』を読んで、”日付や時刻”を扱うことの難しさについて考えた - Magnolia Tech

    ソフトウェア設計のトレードオフと誤り ―プログラミングの際により良い選択をするには 作者:Tomasz Lelek,Jon SkeetオライリージャパンAmazon ソフトウェア開発経験の最初の段階で「一つの機能には複数の選択肢が有って、メリット・デメリットがそれぞれ有り、それらはトレードオフの関係に有り、容易には決めることができない」という事実を教えてもらえる機会に遭遇できていれば、その人はとても幸運だと思う。 先輩や上司が一方的に、「一つの確かな方法」をただ伝える、みたいな場面(それが必ずしも一般的にはそうとは言えない方法であったとしても)も多いのではないでしょうか。 どんなに設計上の意思決定ができている人でも、その頭の中では「色々な選択肢の中で悩んで、ベストではないかもしれないけど、前の前の課題に対してよりベターな方法」を選んでいる。でもその思考の過程を見せてくれる人はとても少ない。

    『ソフトウェア設計のトレードオフと誤り』を読んで、”日付や時刻”を扱うことの難しさについて考えた - Magnolia Tech
  • 組織のコミュニーケーション速度について - Magnolia Tech

    コミュニーケーションには一定の時間がかかる、更にその内容が全員に同じレベルで浸透するにはもっと時間がかかる、更にその内容に従って行動するのは更に更に時間がかかる この時間の長い、短いは、組織の大きさや、文化にもよるし、浸透度のレベル感をどこで許容するかによって変わる— magnoliak🍧 (@magnolia_k_) July 16, 2023 組織が何を重要視するかによって、その浸透度のスピードは全然変わってくるんだけど、外部の人がその期待値より遅いなって感じる時は、それはあなたの期待値が、あなたが考えるほど重要視されていない、と理解した方がいいと思うのです じゃあ、その優先度を変えさせるのか、それに合わせるのかって話— magnoliak🍧 (@magnolia_k_) July 16, 2023 「社長が言えばすぐにかわるんだろう?」みたいな発言をしている人を見たことがある。

    組織のコミュニーケーション速度について - Magnolia Tech
  • 『レガシーコードとどう付き合うか』は、経営層とエンジニアサイドの価値観の橋渡しをしてくれる稀有な一冊 - Magnolia Tech

    レガシーコードとどう付き合うか 作者:めもりーシーアンドアール研究所Amazon めもりーさんの『レガシーコードとどう付き合うか』を読んだ。 これは優秀なプログラマであり、CTOとして経営に参画しためもりーさんならではの1冊でした…とはいえ、果たして人生何周目だったらその経験をここまで分かりやすく言語化できるのか分からない。 簡単に言えば、以下の記事の完全版、というか、経営とエンジニアの両サイドから見た「企業が顧客に価値を届けるという営みにおける”エンジニアリング”とは何か?」というテーマなんじゃないかと思います。 note.com [目次] CHAPTER 01 なぜレガシーコードが生まれやすいのか CHAPTER 02 レガシーコードを改善するための道筋 CHAPTER 03 レガシーコードを読む力 CHAPTER 04 レガシーコードを改善するための準備 CHAPTER 05 レガシ

    『レガシーコードとどう付き合うか』は、経営層とエンジニアサイドの価値観の橋渡しをしてくれる稀有な一冊 - Magnolia Tech
  • YAPC::Kyoto 2023にオンライン参加した - Magnolia Tech

    久しぶりのオフライン開催YAPC!! (オンライン開催が当たり前になってきたので、わざわざオフラインって言うようになったのは、回転寿司に対する固定寿司みたいな言い方ですよね) 自分がスタッフ参加したYAPC::Tokyo 2019が終わった後に「次は京都か?」という話が出て、実際に2020年に開催が決まったものの、無念の延期決定...そこからの復活! とはいえ、残念ながら現地参加は叶わず......そしてオンラインも夕方になってようやく参加できた、ということでちゃんと通してみれた発表はyusukebeさんのHonoの開発経緯と、LT、大西さんのキーノートくらい yusukebeさんのトークも、大西さんのキーノートも、「人とのつながりが有って、今ここに居る」感がすごく良かったですね。二つの発表は時間軸こそ全然違うんですけど、色々なことが繋がって、その先へ進んでいく感じが(偶然にも)シンクロし

    YAPC::Kyoto 2023にオンライン参加した - Magnolia Tech
  • 『Go言語プログラミングエッセンス』を読み始めた - Magnolia Tech

    Go言語プログラミングエッセンス エンジニア選書 作者:mattn技術評論社AmazonGo言語プログラミングエッセンス』、C言語の勉強に役立つなぁ(?)— magnoliak🍧 (@magnolia_k_) 2023年3月11日 普段、Go言語のコードを書くことは無いのだけど、ざっと読むくらいのスキルは身につけておきたいなーと思って、『Go言語プログラミングエッセンス』を読み始めた。 単に言語の仕様とか、ツールの使い方を知りたいだけならば公式ドキュメントを読んで、他の人のコードを読んで、実際に書いてみればいいのだけど、このではしつこいくらいに、「他の言語との比較」や、「仕様が決まった背景」が語られている。 変数や関数の定義の記述順に関しては、わざわざC言語の構文解析の難しさを図を使ってまで説明した上で、「一方、Go言語ではこうなっている」と説明されてとても分かりやすかった。 この

    『Go言語プログラミングエッセンス』を読み始めた - Magnolia Tech
  • 『学びの構造』を読んで、自分の学び方や、他人の学び方を見直そう - Magnolia Tech

    「学び」の構造 作者:佐伯 胖東洋館出版社Amazon TwitterのTLで見かけた、佐伯 胖さんの書かれた『学びの構造』というが気になって読んでみた。 昭和50年に発行されて、今年になっても増刷されている歴史ある1冊。 元々、学校教育の現場の人向けに書かれているみたいだけど、「学ぶことを指導する立場」の人であれば必ず刺さる内容ばかりだった。 特に第二章の”「おぼえる」ことと「わかる」こと”で語られている、「わかる」の定義は必読。 「わかる」とは「わからないところがわかる」ことだと定義し、そこから「わからない部分」に行き当たると「疑問がわき」、それが全体を統合する働きをする、という流れは非常に納得感が有った。 そう、確かに分かっていないと疑問にも思わないし、質問も出てこない。そして「分かった気になって」、やろうとしても実は理解していないから「手順通りのこと」はできても、その先ができな

    『学びの構造』を読んで、自分の学び方や、他人の学び方を見直そう - Magnolia Tech