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

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

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

    『読み手につたわる文章 - テクニカルライティング』を読んで、レビューテクニックを身につけよう! - Magnolia Tech
    yarumato
    yarumato 2024/06/02
    “文書が分かりづらい時、自分がチェックするのは、1,事実と推測が混ざってない? 2. いつまでに何をやってほしいのか明確か?(ビジネス文書は誰かの行動を変容するために書かれる。ボヤけると意味がない)”
  • 2023年買ったもの(技術書とか) - Magnolia Tech

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

    2023年買ったもの(技術書とか) - Magnolia Tech
    yarumato
    yarumato 2024/01/02
    “ちゃんと理解する気持ちで、コードを書いたり、周辺情報を調査したり、周りの人とディスカッションしながら読み進めたら、平気で1年かかる密度の本です。 現代的なソフトウェアのプラクティスが、ものすごい密度で
  • 『なっとく!関数型プログラミング』は読者の理解度の進捗を先読みして作り込まれた”プログラミング入門”の良書 - Magnolia Tech

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

    『なっとく!関数型プログラミング』は読者の理解度の進捗を先読みして作り込まれた”プログラミング入門”の良書 - Magnolia Tech
    yarumato
    yarumato 2023/08/07
    “Javaで書かれた命令型のコードから、Scalaで書かれた関数型のコードとの比較に始まり、関数型のコードが守るべき純粋関数の3つのルールを守るためのコードはどうやって書けば良いのか?を徹底的に、詳細に解説。”
  • 僕らはいつまでUSB Type-Cケーブルを選ぶのに迷うのだろう…まだ迷っている人のための覚え書き - 2021年、夏 - Magnolia Tech

    自分用の買い物メモ、Thunderbolt4ケーブルが続々とリリースされてきたので、2021年夏用にアップデート。 いつもの「全部同じじゃないですか」案件。 USB Type-Cケーブルの選び方は難しい…あらゆる規格をサポートするけど、あらゆる規格を”同時に”サポートするわけではないので、主にケーブル長や用途などで上手く選ばないと、使えなかったり、無駄に高いケーブルを選ぶことになってしまう そんなことを起こさないためのメモ あれこれ迷わないための”全部入り” 低速から高速まで色々な周辺機器の接続に使う(USB2.0, USB3.2, USB4, Thunderbolt3, 4) ディスプレイ接続に使う(DisplayPort) 給電に使う(最大100W) などなどを考えると、Thunderbolt4のケーブルを選ぶと全部対応している。長さは2.0mまで選べる。 Thunderboltのマー

    僕らはいつまでUSB Type-Cケーブルを選ぶのに迷うのだろう…まだ迷っている人のための覚え書き - 2021年、夏 - Magnolia Tech
    yarumato
    yarumato 2023/03/11
    “あれこれ迷わない全部入りならThunderbolt4のケーブルを選ぶと「ディスプレイ接続に使う(DisplayPort) 、給電(最大100W)」も全部対応している。長さは2.0mまで選べる。価格は0.8mで3000円、2.0mだと倍の6000円”
  • 一家に一冊『詳解UNIXプログラミング 第3版』 - Magnolia Tech

    詳解UNIXプログラミング 第3版 作者:W. Richard Stevens,Stephen A. Rago翔泳社Amazon 先日、sambaのソースコードを読んだ話をブログに書いた。 blog.magnolia.tech その時に、傍に置いて参照したのが『Advanced Programming in the UNIX Environment』、邦題『詳解UNIXプログラミング 第3版』。 手元には10年前に買った原著しかなく、和訳の紙版を買おうとしたら、いつの間にかどこにも売られていなくなってしまっていた......電子書籍版は今でも入手できるけど、この手の定番書籍は紙で持っておきたいんだよなぁ。 内容は、Linuxmacos、FreeBSD、Solarisなどのシステムコールや、POSIX仕様と照らし合わせながら各OSの差異などがB5・896ページに渡って解説された凄まじい1冊

    一家に一冊『詳解UNIXプログラミング 第3版』 - Magnolia Tech
    yarumato
    yarumato 2023/02/20
    “内容は、Linux、macos、FreeBSD、Solarisなどのシステムコールや、POSIX仕様と照らし合わせながら各OSの差異などB5・896ページに渡って解説。プロセス、ファイル入出力、ネットワークなど、POSIX準拠なOSの挙動を理解”
  • 『マスタリングLinuxシェルスクリプト 第2版』、こういう1冊手元に有るとずっと使える本はちゃんと買っておきたいですね - Magnolia Tech

    マスタリングLinuxシェルスクリプト 第2版 ―Linuxコマンド、bashスクリプト、シェルプログラミング実践入門 作者:Mokhtar Ebrahim,Andrew MallettオライリージャパンAmazon 令和最新版のシェルスクリプトの入門書とリファレンスがセットになった1冊。手元に置いておくと安心感ありますよね。 令和最新版なので、冒頭からデバッグしたいならVisual Studio Code がオススメ、と出てきます。 コンテナ使おうと思ったらシェルスクリプトの読み書きの出番がどんどん増えていって、コンテナに一番必要なスキルはシェルスクリプトのスキルでは?と思っている今日この頃です(違います)が、そのくらいの用途に必要な要素は全部盛り込んであり、シェルスクリプトの文法と実践的な使い方に加えて、一緒に利用されることの多いgrep、awk、sedといったコマンドの解説も併せて載

    『マスタリングLinuxシェルスクリプト 第2版』、こういう1冊手元に有るとずっと使える本はちゃんと買っておきたいですね - Magnolia Tech
    yarumato
    yarumato 2023/01/22
    “コンテナに一番必要なスキルはシェルスクリプトのスキルでは?と思っている今日この頃。最後の章は「bashスクリプトの代わりとしてのPython」という内容で、もうそこはPerlじゃないんだよなーって”
  • 『ちょうぜつソフトウェア設計入門――PHPで理解するオブジェクト指向の活用』は、現代ソフトウェア開発の”知の高速道路” - Magnolia Tech

    ちょうぜつソフトウェア設計入門――PHPで理解するオブジェクト指向の活用 作者:田中 ひさてる技術評論社Amazon 予約してまで買ったものの、なかなか時間が取れず、読めていなかった『ちょうぜつソフトウェア設計入門――PHPで理解するオブジェクト指向の活用』をようやく読み終わりました。 筆者である田中ひさてるさん自身で描かれた表紙の可愛らしさからは想像もできないハードな内容なので、一気に読もうとすると「分かった気」になるだけで全然理解していなかった、ということになりがちなので、3回くらいぐるぐる読むといいと思います(そうです、この文もイラストも丸っと同じ人が書いているのです!!)。 目次 第1章 クリーンアーキテクチャ 第2章 パッケージ原則 第3章 オブジェクト指向 第4章 UML(統一モデリング言語) 第5章 オブジェクト指向原則 SOLID 第6章 テスト駆動開発 第7章 依存

    『ちょうぜつソフトウェア設計入門――PHPで理解するオブジェクト指向の活用』は、現代ソフトウェア開発の”知の高速道路” - Magnolia Tech
    yarumato
    yarumato 2022/12/25
    “タイトルに"PHP"とは出てきますが、それほどコード量は多くなく、理解するための補助的な役割として出てくるので、PHPに不慣れな人でも大丈夫”
  • 「WEB+DB PRESS Vol.130」の「イミュータブルデータモデルで始める 実践データモデリング」は必読なので、マジで今すぐ本屋へ走って買おう - Magnolia Tech

    WEB+DB PRESS Vol.130 技術評論社Amazon 川島さんの「イミュータブルデータモデルで始める 実践データモデリング」は必読なので、マジで今すぐ屋へ走って買おう、としか言いようの無い、お得情報満載。 ビジネス要求の持つ複雑を表現しているモデル、表現していないモデルの境目が分かるようになるし、そもそも「複雑とは何か?」ということが分かるようになる。 あと、「モデルとして複雑な物はどう表現しても複雑…だけど、それを扱うアプリケーションの複雑さを軽減することができる」という考え方、視点が得られるだけでも超お得。 音読しよう、100回読もう、枕元に置いて夢の中でも読もう どうやっても複雑さは減らないので、複雑さをコントロールできるようにしていこう!! もう一回読もうっと。 モデルだけで複雑さのコントロールに打ち勝てるわけじゃないけど、モデルになるべくそのドメインが持つ「複雑さを

    「WEB+DB PRESS Vol.130」の「イミュータブルデータモデルで始める 実践データモデリング」は必読なので、マジで今すぐ本屋へ走って買おう - Magnolia Tech
    yarumato
    yarumato 2022/08/29
    “ビジネス要求の持つ複雑を表現しているモデル、表現していないモデルの境目が分かるようになるし、そもそも「複雑とは何か?」ということが分かるようになる。”
  • 『理科系の作文技術』を久しぶりに読み返し、とにかく「6 はっきり言い切る姿勢」「7 事実と意見」だけは絶対にみんな読んだ方がよい、と思った - Magnolia Tech

    理科系の作文技術(リフロー版) (中公新書) 作者:木下是雄発売日: 2016/10/14メディア: Kindle版 いまさら紹介するまでもないけど、とりあえず作文方法を学びたい時は、まずはこの「理科系の作文技術」を読むことをお勧めする。 最近ブログのエントリをざっと書いてそのまま公開してしまうことが多かったので、少し反省し、それを直すためにこのを改めて読み直した。そうしたら、タイトルで全部言い切っているのだけど、とにかく「6 はっきり言い切る姿勢」「7 事実と意見」だけは絶対にみんな読んだ方がよい、と思った。 日常的にメールや、ブログの記事など、それなりの量の文章を書くことが多いけど、論文や雑誌の記事など、きちんと他人の目を通した上で公開される文章を書くことは、まずない。一度だけ、雑誌の記事原稿を書いたとき、自分なりにかなりの推敲を重ねたつもりでも、プロの編集の方から見れば言葉使いや、

    『理科系の作文技術』を久しぶりに読み返し、とにかく「6 はっきり言い切る姿勢」「7 事実と意見」だけは絶対にみんな読んだ方がよい、と思った - Magnolia Tech
    yarumato
    yarumato 2021/01/24
    “英語の「ステート」は“明確に表明する”という意味。類する言葉が日本語にない。ステートするときには当然,一句一句に責任がともなう。「事実」と「意見」を適切に分離しているか”
  • 「NO HARD WORK!」を読んで、“説明責任”と、“コンテキストスイッチコスト”について思いを巡らせた - Magnolia Tech

    NO HARD WORK! 無駄ゼロで結果を出すぼくらの働き方 (早川書房) 作者:ジェイソン フリード,デイヴィッド ハイネマイヤー ハンソン発売日: 2019/01/31メディア: Kindle版 「リモートワークの達人」を書いたジェイソン・フリードと、ディヴィッド・ハイネマイヤー・ハンソン(DHH)の「NO HARD WORK!」をようやく読んだ。 2018年に原著が出版され、去年日でも翻訳が出た、二人の最新作だ。 ちなみに、原題は「It Doesn’t Have to Be Crazy at Work」となっていて、「リモートワークの達人」のときもそうだったけど、原題の方がいいなと思う。 なお、「リモートワークの達人」の感想エントリはこちら。 blog.magnolia.tech 今回は「仕事だけに忙しく、クレイジーに働きすぎない」というテーマだ。世の中の働き方がそうなっているこ

    「NO HARD WORK!」を読んで、“説明責任”と、“コンテキストスイッチコスト”について思いを巡らせた - Magnolia Tech
    yarumato
    yarumato 2020/12/16
    “Ruby on RailsのDHHの書籍『NO HARD WORK!』(2018) 高すぎる目標設定がストレスとなって正しい判断や行動を阻害。アウトプットの質を下げてでも説明責任を果たす方向に行ってませんか? ステークホルダーへの説明が過剰”
  • 僕らはいつまでUSB Type-Cケーブルを選ぶのに迷うのだろう…もう間違えないための覚え書き - Magnolia Tech

    2021/8/6更新 Thunderbolt4ケーブルがリリースされてきたので、アップデートしました。 blog.magnolia.tech 自分用の買い物メモ USB Type-Cケーブルの選び方は難しい…あらゆる規格をサポートするけど、あらゆる規格を”同時に”サポートするわけではないので、主にケーブル長や用途などで上手く選ばないと、使えなかったり、無駄に高いケーブルを選ぶことになってしまう そんなことを起こさないためのメモ あれこれ迷わないための”全部入り” 低速から高速まで色々な周辺機器の接続に使う(USB2.0, USB3.1, Thunderbolt3) ディスプレイ接続に使う(DisplayPort) 給電に使う(最大100W) などなどを考えると、長さが1.0m以下で、USB PD 5A(100W)対応と書かれているThunderbolt3ケーブルを選ぶと全部対応している。

    僕らはいつまでUSB Type-Cケーブルを選ぶのに迷うのだろう…もう間違えないための覚え書き - Magnolia Tech
    yarumato
    yarumato 2020/12/12
    “ディスプレイ接続用のtype-Cケーブルを買う場合 給電用のtype-Cケーブルを買う場合 あれこれ迷わないための全部入り”
  • プログラマの三大美徳について…その原典ではどう語られているのか - Magnolia Tech

    プログラミングPerl〈VOLUME1〉 作者:ウォール,ラリー,オーワント,ジョン,クリスチャンセン,トム発売日: 2002/09/01メディア: 単行 何度も読み返す技術書の話題で忘れてはいけないのがPerlの作者であるLarry Wallが書いた「Programming Perl」。 このPerlというプログラミング言語に関する解説書である共に、定期的にブログなどで話題になる「プログラマの三大美徳(無精、短気、傲慢)」に ついて解説されている原典でもある。 この三大美徳…意外と原典ではストレートには語られていない点も興味深い。三大美徳の中身は散々語られているので、ここでは原典でどのような流れで語られているのか調べた。 Perl自体の人気もだいぶ下がっているし、日語に訳されているのはPerl 5.6対応(20年前!)の第3版しかなく、2012年に出版された第4版は日語には翻訳

    プログラマの三大美徳について…その原典ではどう語られているのか - Magnolia Tech
    yarumato
    yarumato 2020/11/30
    “「Programming Perl」(第4版,2012年)で語られる三大美徳。良いソフトウェアデザインと無精、短気、傲慢。偽りの無精:抽象化せずコピペですます。偽りの傲慢:コピペせず過剰な抽象化。偽りの短気:再利用せず自分で書く”
  • 「リモートワークの達人」を読んだ、そして悔しい思いをした - Magnolia Tech

    リモートワークの達人 (ハヤカワ文庫NF) 作者:ジェイソン フリード,デイヴィッド ハイネマイヤー ハンソン発売日: 2020/07/02メディア: Kindle版 「リモートワークの達人」を読んだ このはBasecamp社のジェイソン・フリードと、ディヴィッド・ハイネマイヤー・ハンソン(DHH)が書いた「Remote: Office Not Required」の翻訳で、単行では「強いチームはオフィスを捨てる: 37シグナルズが考える「働き方革命」」という書名だったものがこの夏に文庫化にあたって改題されたもの。 既に2014年に出版されて散々話題になっていたらしいのだけど、実は全然知らず、つい最近「リモートワークの課題はもう全部このに書いてあって、DHHたちが通った道だ」と教えていただき、早速買ってみた。 いや、当に悔しい。 これはコロナ禍以前の、世間でリモートワークがまだ普及し

    「リモートワークの達人」を読んだ、そして悔しい思いをした - Magnolia Tech
    yarumato
    yarumato 2020/11/10
    “Ruby on RailsのDHHたちが書いた2014年のこの本にリモートワークの課題は全部書いてある。前半の「リモートワークの誤解を解く」は今や常識。中盤からのコラボレーション術・人材採用・マネジメントは今だからこそ有益”
  • 1