質の高い技術文書を書く方法 - As a Futurist...
大学や大学院で論文の書き方を鍛え上げた人たちには遠く遠く及ばないが、僕の様なはぐれもの1でも最近は Amazon 社内で文書の質が高いと評価してもらえるまでにはなった。Software Engineer として、コードでのアウトプットはもちろん大事だけど、文書のアウトプット(およびそれによって得られた実際のアウトプット)は同じだけ重要である2。今回は自分が最近どういうところに気をつけて技術文書を書いているのか、ということについて数年後の自分が忘れてないことを確かめられる様にまとめておく。 そもそも文書とは？ 英語だと document。ここで指す(技術)文書とは、人間が読む文体で書かれた技術に関連する情報、といったものだ。具体的に言うと以下の様なものを想定している: 新しいプロジェクトの骨子を説明する資料 会議の叩き台となる 1 枚ペラ 本番環境に変更を加えるにあたっての包括的な情報や具体
技術書の予習と復習
どうも、株式会社プラハCEO兼エンジニアの松原です 最近若手エンジニアから「技術書や記事からのインプットが遅い、あるいは浅いことに悩んでいる」と相談を受けました。 (自分のインプットの巧拙はひとまず棚に上げて)自分は技術書を読む際は予習と復習を結構するタイプなので、自分なりに工夫していることについて書き残してみようと考えました。超オレオレ理論ですが、悩んでいる方の参考になれば幸いです 本の予習と復習 自分は技術書を読む前後でこんなことをしています: (予習)その本にかける時間を決める (予習)本から学びたいことを書き出す (予習)胡散臭い人に書かれたと考える (復習)仮説を作り、検証する (復習)自分の行動の変化を書き出す (復習)記事を書くか、人に話す 結構面倒だと思いますが、自分にとっては効果的でした 0. その本にかける時間を決める 自分がこれから説明する予習と復習は、めちゃくちゃ時
弁護士ドットコムクリエイターブログの軌跡と振り返り - 弁護士ドットコム株式会社 Creators’ blog
弁護士ドットコム株式会社 Creators' Blog の運営開始から半年が経過しました。何を目指して、どのような運用をしていたか公開します。 記事の公開戦略やレビュー体制にも触れているので、技術ブログを立ち上げようとしている人の参考になれば幸いです。 技術ブログを立ち上げた理由 記事内容の方針 レビュー体制 定期的に記事を発信するために 立ち上げ初期 3か月後~ うまくいった施策 月ごとに、Spread sheetで書いてくれる人をまとめ 「ブログ期待」Slackスタンプ 月1の編集会議 失敗した施策 Google Formで記事のネタを募集 半年でできた拡散戦略 成果 はてなブックマークランキング Twitterでの絡み 採用 これから 技術ブログを立ち上げた理由 弁護士ドットコムでは社外に向けていろいろな情報を発信していますが、発信の方法は各部署ごとにさまざまで、ブログも乱立していま
弁護士ドットコムでの技術課題への向き合い方 -Tech Focus Day- - 弁護士ドットコム株式会社 Creators’ blog
はじめに こんにちは。弁護士ドットコム株式会社エンジニアの@shinfkdです。 普段は社名と同じ弁護士ドットコムというサービスを運営する開発部で、部長をやっております。 本記事では、弁護士ドットコム事業における技術課題に対する取り組み、 Tech Focus Day(通称 TFD)についてご紹介します。 はじめに Tech Focus Day(TFD)って何 TFDをはじめた背景 TFDの前身 Bug Fix Week TFDの誕生 TFDの運用と変遷 TFD Ver2.0 クエストボード制 TFD の成果とまとめ Tech Focus Day(TFD)って何 弁護士ドットコムでは現在、毎週金曜日を Tech Focus Day(以下 TFD) と称し、集中的に技術課題の対応をしています。TFD は Tech に Focus する Day、すなわち技術課題に集中して取り組む日という意味で
what we use（技術スタックデータベース）
Azure Databricksを中心としたデータ基盤への刷新。データをグループ会社横断で活用し、価値創出を行う施策
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
