「コードを書くのは好きだけどドキュメントは苦手」 「ドキュメントはつい後回しにしてしまう」 エンジニアの皆さん、そんな覚えはありませんか？ 本書は、日本語ドキュメントのスペシャリストであるテクニカルライターの著者が、エンジニアが「いつ」「何のドキュメントを」「どうやって」書けばよいのかを、イチから解説します。 先生役の著者と生徒役をキャラクターにし、全編にわたってイラストを豊富に掲載。 はじめてドキュメントを書くエンジニア、またはこれまで自己流で書いてきたエンジニアが、一度読めば一生使える知識満載です。 装丁画と挿絵は、カケヒジュンさんが手がけます。 ＜基礎編＞ Chapter１ 良いドキュメントを効率良く書くために Chapter２ ドキュメントの読み方を理解する Chapter３ 読み手とテーマを選定する Chapter４ テーマを分解する Chapter５ ドキュメントの骨組みを組む
はじめにクレディセゾンに来てちょうど５年が経ったので、これまでの取り組みをまとめてみようかと思う。書き進めていくうちにとても長くなってしまったので、1年につき3トピックに絞ってあとはカットした。それでも5年分なこともありかなり長くなったので、目次から各トピックに飛んでもらえればと思う。社内の関係者も読むかもしれず、「自分のやったことが載ってない！」と思うこともあるかもしれないが、内製開発案件だけでも53案件あり全部載せるととんでもない量になるので許してほしい。それから、振り返ってまとめると退職すると勘違いされるかもしれないけれど、退職するわけではありません！ 2019年：ゼロからのスタート1-1. 内製開発エンジニア募集を始める「日本のそれなりの規模の事業会社の中に、内製開発チームを立ち上げることはできるのだろうか？」 2019年3月、クレディセゾンに来たばかりの私にとってはこの質問への答
フロントエンドのパラダイムを参考にバックエンド開発を再考する / TypeScript による GraphQL バックエンド開発
Ruby コミュニティから「レオ (Leo)」の愛称で親しまれる Leonard Chin が 2023 年 10 月にアンドパッドに hsbt のリファラルで入社しました。今回はそのリファラルの模様と、レオのようなシニアエンジニアがどのように企業研究を行い、転職先企業を決定したのか、 10 数年来の友人である hsbt がその過程をインタビューしました！ Leonard Chin @lchin オーストラリア出身、日本在住歴 20 年の Rubyist。旧時代の RubyKaigi でテキストでの擬似同時通訳を担当。 Asakusa.rb 休眠会員。クックパッド株式会社に 10 年在籍し、 2023 年にアンドパッドに転職ならぬ “転パッド” を決める。hsbt 柴田 博志 hsbt フルタイム Ruby コミッタとしてアンドパッドに入社。 Ruby, RubyGems, Bundler
最近、毎日のようにEMのいくおさん（ @dora_e_m ）とTwitterXでわちゃわちゃしてる。彼のポストを見ていると、ガンプラをつくるかビールを飲むかしかしていないように見えるが、それで合っている。 という冗談はおいといて真面目な話をすると、エンジニアとしての僕は彼と仕事ができている今の時間のことを本当に貴重な時間だと思っている。とにかく仕事がしやすいし、いろいろな気づきを与えてくれるおかげで、自分自身の成長も感じている。 エンジニアリングマネージャとしての知識が豊富でスキルが高いというのはもちろん、人との接し方や日常的なふるまいもとても尊敬できるものなのだ。 そこで今日は、僕が彼とこの3ヶ月間仕事をしていて、やりやすい・尊敬していると感じていることの中から10個だけ簡単に紹介しようと思う。僕からいくおさんへの日頃の感謝の気持ちをあらためて書いておこうと思っただけとも言う（ふだんから
近年は、エンジニアを束ねるエンジニアリングマネージャー(EM)を採用する組織が増えています。 デリバリーに軸足を置くプロダクトマネージャーに対して、EMはエンジニアのピープルマネージメントに軸足を置いています。 そんなEM渇望の一冊が、先月末にオライリーから出版されました。 エンジニアリングマネージャーのしごと ―チームが必要とするマネージャーになる方法 : James Stanier 社内でも、今週月曜から部門横断の読書会が始まったばかりです。 その翌日に、Forkwell のイベントで同書の翻訳に関わった 吉羽龍太郎/@ryuzee 氏によるエンジニアリングマネージャーに関する講演を視聴する機会がありましたので、かんたんにレポートを共有します。 Forkwell イベント概要 エンジニアリングマネージャーのしごと - Forkwell Library #5 - connpass 公式レ
組織内のメンバーを「リソース」として見始めると、それを100%使い切ることにばかり注力してしまいます。リソースの稼働率を下げることは、すなわち、生産性を下げること。マネージャーは、まるで強迫観念に取り憑かれたように、そのような考えに囚われます。 自社でのソフトウェアプロダクト開発において、その対象は特に、開発者に強く向けられます。その理由は明らかでしょう。バックログに積み上がり続けるアイデアをソフトウェアに変えられるのは、開発者だけです。より多く、できる限り早く、アイデアを市場投入したい。彼らに空き時間という無駄を作らせてしまうわけにはいかない。 しかし、そのような努力が、必ずしも良い結果につながるとは限りません。むしろ、開発者の稼働率を高めすぎたことが、リードタイムに悪影響を与えているかもしれないのです。そして言うまでもなく、アイデアの市場投入が延びれば延びるほど、ユーザーにとってもビジ
NTTコミュニケーションズでエンジニアとして勤務する傍ら、ポッドキャスト『fukabori.fm』配信やさまざまなイベント登壇など、幅広く活躍されている岩瀬義昌（@iwashi86）さん。意外にも、新卒でNTT東日本に入社した際は現在のような多忙なキャリアを描いておらず、「無理せず生きていきたい」と思っていたそうです。 入社して5年ほどたったときに成長に頭打ちを感じ、「本当に自分はこの道を歩みたいのか？」と悩んだ岩瀬さん。なぜ転職ではなく、NTTグループ内での転籍という道を選んだのでしょうか。 その選択で得た刺激、デブサミで受けた衝撃、意外な人事部への異動……。「日本のIT業界を変えたい」という現在の思いに至るまでのキャリアについて、お話を伺いました。 「無理せず生きていけたら」とNTT東日本に入社 入社5年で感じた「頭打ち」、キャリアパスへの疑問 プライベートも含めた総合的な判断で選んだ
転職・求人情報サイトのtype エンジニアtype 働き方 若手エンジニアの成長を妨げる“受託脳”とは？ 「受託開発でスキルアップできない」が大間違いな理由【チェリー本著者・伊藤淳一×遠藤大介】 2023.04.04 働き方 受託 「スピーディーに成長したいなら、受託開発より自社開発」そんなイメージから、受託開発を行う企業から自社開発企業への転職を目指す若手エンジニアは多いかもしれない。 だが、“チェリー本”の愛称でお馴染みの書籍『プロを目指す人のためのRuby入門』執筆者であり、ソニックガーデンのプログラマー・伊藤淳一さんと、同じくソニックガーデンで指折りのプログラミング力を誇る執行役員の遠藤大介さんは、その考えは「必ずしも正解とは言えない」と話す。 二人のエンジニアとしてのキャリアは15年以上。両者ともに、これまで受託開発の仕事を続けながら、現在のポジションを築いてきた。 なぜ、クライ
日本を代表するブログサービスをはじめ、近年ではサーバ監視サービスMackerelでも知られる株式会社はてな。日本におけるWeb開発の黎明期から現在に至るまで、新旧さまざまな技術スタックが混在する環境で、CTOであるmotemenさんこと大坪弘尚さんはどのような心構えで技術選択に挑んでいるのか。初代はてなCTOでもある株式会社一休CTOの伊藤直也さんが聞き出します。 ・伊藤 直也さん / 株式会社 一休 執行役員 CTO 新卒入社したニフティ株式会社でブログサービス「ココログ」を立ち上げ、CTOを務めた株式会社はてなでは「はてなブックマーク」などの開発を主導。グリー株式会社では統括部長としてSNSを担当した。2016年4月、一休に入社し執行役員CTOに就任。 ・大坪 弘尚さん / 株式会社はてな CTO 2008年、東京大学大学院情報理工学系研究科を中退後、アプリケーションエンジニアとして新
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? GPT-4時代のエンジニアの生存戦略 ※ この記事の内容の一部はこちらのイベントでお話したことと重複します。 はじめに 2023年3月1日にOpenAI社よりChatGPTのAPIが公開されました。 さらに14日にはGPT-4が登場し、その翌々日にはMicrosoft 365 CopilotでGPT-4をOffice製品に搭載することが発表されるなど、AI領域で大きな変化が起きています。 変化の速度の速さと変化量の大きさにより、私自身も追いつくのが精一杯な状態です。 個人的には、iPhoneの登場時以上の衝撃を受けています。 人類の歴史
ソフトウェアエンジニアとして安定した成果を出したいと思っている人は多いでしょう。妥当な方針を危なげなく定め、素早く的確に実装し、滞りなく仕事を片付けていきたいものです。しかし、いつでもそのように成果を出せるようになるのは簡単ではありません。言語、ミドルウェア、クラウド、アーキテクチャと、身につけるべき知識が無限に並んでおり、それら全てに習熟する日は永遠に来ないとすら思えてきます。 にもかかわらず、この記事を読むみなさんの同僚には、安定して成果を出せるエンジニアが相当数いるだろうとも思います。これは一体どういうトリックなのでしょう。彼ら彼女らは全てを勉強しているのでしょうか。もちろんそれに近い研鑽を積んでいる人もいるでしょうが、多くの人はそこまでしていないと予想します。少なくとも僕はそこまでやっていませんが、技術面でもそこそこバリューを出して、テックリードを1年勤め上げました。この記事では、
『テスト駆動開発』や『SQLアンチパターン』をはじめとする技術書の翻訳者、さまざまなIT企業をわたり歩く技術顧問、さらに最近ではエンジニアリング文化を伝える講演者としても活躍されている和田卓人さん(https://twitter.com/t_wada)。 そのソフトウェアエンジニアとしての素顔を株式会社一休CTOの伊藤直也さん(https://twitter.com/naoya_ito)が聞き出す対談の前編では、一線を画すエンジニアであり続けるために自らのプロジェクトで意識的にコードを書いているという和田さんの姿勢に始まり、ベテランとして「技術のらせん」を読み解くケーススタディとしてDDD（Domain-Driven Design）を題材に話を伺います。 ・伊藤 直也さん / 株式会社 一休 執行役員 CTO 新卒入社したニフティ株式会社でブログサービス「ココログ」を立ち上げ、CTOを務め
この記事で言いたいことは、まとめると以下のような内容になります。 ・「面倒くさくて複雑」といフローは、例外もあるものの、基本的には不適切であるか、そのフローが必要とされる前提の方がおかしい ・けれど世の中には、「面倒で複雑なフロー程正しいし価値がある」と考える人が案外多い ・「面倒くさい」と言える人は貴重なんだけど冷遇されがち ・不要なJOIN句は敵だし、JOIN句の使い回しなど絶対してはならない よろしくお願いします。 さて、言いたいことは最初に全部言ってしまいましたので、後はざっくばらんにいきましょう。 先日、Twitterでこんなことを呟きました。 エンジニアをしていると「面倒くさいやり方は大抵間違っているか、あるいはそのやり方を必要としている前提の仕組みの方がおかしい」という思考は割と普通だと思うんだけど、どうも世間的には「面倒くさければ面倒くさい程正しい、ないし価値がある」と思っ
タイトルは、ポール・グレアム氏（Yコンビネーター）の「メイカー（作り手）のスケジュールとマネージャーのスケジュール」(Maker's Schedule, Manager's Schedule) からの引用です。 マネージャーは多くのミーティングをこなすなど、1時間単位でタスクにあたりますが、エンジニア（プログラマ）は最低でもまとまった半日単位の時間を作業に必要とする、と書かれています。 paulgraham.com 日本語訳 note.com エンジニア上がりのプロダクトマネージャーとして開発もプロダクトマネジメントも並行してこなしてきたのですが、意思決定のためのミーティングスケジュール、自身が開発を行うためのスケジュールをやりくりするバランスに腐心していました。 自身のタイムマネジメントで特に感じた点として、ミーティングとミーティングの間に1時間が3コマある時の開発生産性と、3時間まとま
こんにちは、LAPRAS CTOの @rocky_manobi です。 タイトルの通り、LAPRASのソフトウェアエンジニア職の選考課題を公開しましたので、その詳細や心についてこの場を借りて紹介します。 公開した選考課題はコチラ GitHub - lapras-inc/exam-swe-template: SWE Backend, Frontend ポジション選考課題のテンプレートリポジトリ SWE Backend, Frontend ポジション選考課題のテンプレートリポジトリ. Contribute to lapras-inc/exam-swe-template development by creating an account on GitHub. github.com どうして公開したのか主に以下を目的としています。 応募の心理的なハードルを下げる会社を評価するための材料を提供する
こんにちは。Forkwell の赤川です。 本記事では、2022年4月時点で Forkwell に登録するIT/Webエンジニアの匿名データのうち1万人分を分析し、年代別・経験別の年収を解説します。単なる平均年収にとどまらない、世代別の年収分布、スキル別の年収分布を詳細に出した過去に類を見ないレポートです。このレポートが、ITエンジニアの年収事情の透明性を高め、個人がキャリアを考えるうえで検討材料となること、また企業の評価が適正になるきっかけとなることを願います。なお、このレポートは個人のキャリアに貢献することを目的として執筆しておりますので、商業媒体での引用等、営利目的で利用したい場合は筆者にご相談ください。それでは見てみましょう。 ITエンジニアの世代別年収は？ 以下のグラフは、ITエンジニア全体の平均年収が世代別にどのように分かれているかを示したものです。（グラフは Googleデー
この記事は技術そのものやエンジニア採用のことがよく分からない経営者へ向けて書いています。エンジニアが読めば当たり前のことが書いてあります。また優秀なエンジニアならこう考えるのではないかというところは、私見によるものなので本当にそうかどうかは分かりません。 募集要項を書く募集要項で最も重要なのは待遇に関するところだと私は思います。具体的に言えば、だいたいの年収です。もちろん業務内容や組織の雰囲気なども重要ですが、業務内容や組織の雰囲気が良ければ年収が低くても働こうと思ってくれるのではないかと考えるのは経営者の奢りであって、そんなエンジニアはほとんどいません。優秀なエンジニアにとってはそのどちらも満たす求人が他にたくさんあるために候補にすらなりません。 逆に業務内容に魅力がなくても年収さえ高ければ良いという優秀なエンジニアも一定数いるはずです。待遇を具体的に書くことはそういった層に響くのではな
mercari.connpass.com 今日はこちらのイベントに参加してきたので、会の様子と感想を書いていこうと思います。 会の概要 本イベントは株式会社LayerX 代表取締役CTOの松本勇気氏と株式会社ソウゾウ 取締役CTOの名村卓が、エンジニアを取り巻く環境、エンジニアの市場価値や評価、エンジニアの教育、など幅広いテーマで「エンジニアのこれから」についてディスカッションするイベントです。 複数プロダクト・組織の立ち上げ、拡大に携わってきた二人に、エンジニアのこれからについてあれこれトークしていただきます。 会に参加したきっかけ 自社で新卒だったり中途エンジニアの採用にも緩く携わっているため、トップクラスの技術力を持つ登壇者のお二人から見て、エンジニア採用に対してどのような意識を持っているのか？や、会のタイトル通りエンジニアのこれからについてどのように考えているのか？というのを聴くた
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
