テクニカルライティングの基本 2023年版
テクニカルライティングの基本を学べます。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 サイボウズの2023年度 新入社員向け研修の資料です。 Twitter：https://twitter.com/naoh_nak 2022年版（初版）：https://speakerdeck.com/naohiro_nakata/technicalwriting
テクニカルライティングの基本を学べます。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 サイボウズの2023年度 新入社員向け研修の資料です。 Twitter：https://twitter.com/naoh_nak 2022年版（初版）：https://speakerdeck.com/naohiro_nakata/technicalwriting
「チームトポロジー」や「エンジニアリングマネージャーのしごと」「スクラム実践者が知るべき97のこと」の著者や翻訳者などで知られる吉羽龍太郎氏が、「ソフトウェアに関わる人が知っておくといいかもしれない法則10個（勝手セレクション）」という興味深いポストをX（旧Twitter）で公開しています。 ソフトウェアに関わる人が知っておくといいかもしれない法則10個（勝手セレクション） コンウェイの法則 パレートの法則 グッドハートの法則 パーキンソンの法則 ブルックスの法則 リトルの法則 ピーターの法則 ハインリッヒの法則 ピーク・エンドの法則 ホフスタッターの法則 — Ryutaro YOSHIBA (@ryuzee) January 23, 2024 これらの法則の多くは経験則だったりもしますが、いずれにせよ知っておくと上司の説得に役立ったり、ソフトウェアの開発現場でチームの運営に役立ったり、物
2024年1月時点のAWSベストプラクティスに従って作成しました 好評でしたら続編も検討します 1. 環境ごとにアカウントを分離する 本番、検証、開発ごとにアカウントを分割しましょう ✕良くない例 ◎良い例 最初にアカウント分割しておかないと、後で分割するのはとても大変です アカウントを分割することで「検証と思って作業したら、実は本番だった」のような事故を減らすことができます コストがアカウント単位で集計されるため、環境ごとのコストを簡単に算出することができます AWS Organizationsを使用することで、各環境に応じた権限設定が簡単にでき、ガバナンスを強化することができます AWSアカウントはAWS Control TowerのAccount Factoryを使用することで、クレジットカード情報を都度入力することなく簡単にアカウントの払い出しが可能です また、AWS Contro
自分は当該番組（通称サンソン）をたまに聴いており、いつもはおじいちゃんとそこに集う類友のたわいないハガキと 選曲を楽しんでいるのだが、週半ばにコメントを出すと事務所が告知して以降、どうせロクなことは言わないんだろうなと思っていたら案の定そんな感じだった。 今回の番組の構成も踏まえつつ、結局彼が何を伝えたかったかを考察し、どう受け止められるかを観察する。 山下達郎のファンの方で何故こんなに炎上しているのかわからないひとにも一読していただけると幸いである。 ＜参考リンク＞ コメント全文書き起こし増田 https://anond.hatelabo.jp/20230709143809 今日の放送radikoタイムフリー（冒頭から） https://radiko.jp/share/?sid=FMT&t=20230702140000 （コメント部分頭出し）※約7分 https://radiko.jp/
マジでBLEACH初めて読んだ｜ジスロマック
みなさまには、「明らかに見た記憶はあるのに、内容は全く覚えていない」という状態の作品があるだろうか？ 私には、かなりある。 より具体的に言えば、「明らかに“見た”という記憶はあるのに、子供の頃の記憶すぎて内容はサッパリ覚えていない」という状態の作品が、ものすごく多い。 『機動戦士ガンダムOO』や『コードギアス 叛逆のルルーシュ』、『おねがいマイメロディ』に『絶対可憐チルドレン』……どれもこれも、「見た」記憶はあるのに、内容はよく覚えていない。だから、今こそ見直したい。特にその中で存在感が大きかったのが……………… 『BLEACH』1巻より そう、『BLEACH』なのです。 ちょうど前、アニメの千年血戦篇を見ていた時、ふと気がついたのです。私は、BLEACHを見た気がしていたけど、実は全く内容を覚えていない。というか、微塵も記憶の中に存在していない。そもそも、私はマンガのBLEACHを読んだ
食品添加物の中でもなぜか嫌われるランキング上位の「乳化剤」について今回は語ろう。 思うに、乳化って一番理解出来ないから嫌われてるんじゃないのかなと思ってるんだよね（偏見）。よくある論調が↓に示すようなやつ。そこら辺のヤフー知恵袋から拾ってきた。 乳化剤は種類が多くあらゆる加工食品に使用されています。 実体は洗剤の界面活性剤と同じ成分ですが、 これほど有害であっても害は業界によって隠されています。 https://detail.chiebukuro.yahoo.co.jp/qa/question_detail/q11266853236 なんていうか、真実が2割くらい入ってるのがまたやらしいところ。 あ、8割は嘘なんですけど。 そんなわけでこのエントリでは、そもそも界面とは？ 乳化剤とは？ 乳化とは？ というところを語っていきたいと思う。 ・そもそも「界面」ってなんなの？ 「界面活性剤」の良く
TypeScriptとドメイン駆動設計（DDD）を組み合わせ、APIを構築するハンズオンガイドです。この本では、DDDとは何かという基礎的なところからソフトウェア開発における戦略的設計、戦術的設計まで、包括的な知識を提供します。 戦略的設計では、ビジネスの要求に合わせたドメインモデルの設計をイベントストーミングを用いて行います。その後、戦術的設計では、具体的なコードの実装に関連するDDDの原則と実践を学びます。 TypeScriptを使ってコードを書きながら、DDDの概念を実際のプロジェクトに適用するヒントを紹介します。
GitHub、脆弱性のあるコードを実際にデバッグして学べる「Secure Code Game」シーズン2がスタート
GitHub、脆弱性のあるコードを実際にデバッグして学べる「Secure Code Game」シーズン2がスタート 「Secure Code Game」は、ゲームと名付けられていますが、実際のコードを月間60時間無料で提供されるGitHub Codespacesの機能を駆使して修正し、ユニットテストを通して完成させる手順となっており、実践に近い内容となっています。 昨年（2023年）3月に開始されたシーズン1は、PythonとC言語でのセキュアなコーディングを学べる内容でした。今回のシーズン2ではこれらに加えてJavaScript、Go、そしてGitHub ActionsのYamlファイルなどが含まれており、これらのコードのバグを修正することになります。 Secure Code Gameの始め方 「Secure Code Game」の始め方は次の通りです。 まず「Secure Code G
Code Tour を使ってじっくり確実にコードを読む
日々のタスクに忙殺されていると、ついつい既存コードを流し読みして、ざっと動くコードを書いてしまいたくなります。 一発でうまく動けば短期的にはいいのですが、長期的にはコードの理解が追いつかなったり、一発でうまく動かなかった場合にかえって時間がかかってしまいます。 VSCode の拡張機能である Code Tour を使うと、コード上にメモを残しながら読み進めることができるので、既存のコードを読む際に便利です。 Code Tour とは VSCode の拡張機能で、コード上にメモを残しつつ、そのメモをたどることができるツールです。 使い方 ツアーを始める コマンドパレットから「Code Tour: Record Tour」を選択すると、ツアーの記録モードになります。 ツアーの名前 どのソースに紐づけるか（紐付けなし、ブランチ、タグ） を選択すると、リポジトリ直下に .tours/${指定したツ
ピーちゃん @usa_wanwanwanko #初投稿 です。 当時付き合っていた彼が東京の大学に行くことになりました。 ついて行けない私は、うさぎのぬいぐるみを買って、代わりに連れて行ってもらいました。 そのぬいぐるみは、パペットになっていて、手を押すとピーと鳴る、なんとも愛らしいぬいぐるみでした。→ #吉徳 #ぬいぐるみ pic.twitter.com/dP45cocdei 2023-10-03 11:32:27 ピーちゃん @usa_wanwanwanko →東京で一人暮らしを始めた彼は、その子を｢ピーちゃん｣と名付け、話しかけていたそうです。帰省の時はピーちゃんも連れて帰ってきて、一緒に出かけました。 ピーちゃんが6歳になった時、私達は結婚しました。子供も生まれ、ピーちゃんは娘の部屋で過ごすようになりました。→ #吉徳 #ぬいぐるみ pic.twitter.com/IiTiyI4g
＜原爆開発をテーマにしたこの作品を、被爆国日本は当事者として評価する権利がある＞ 現在、世界で最も注目されている映画監督の1人、クリストファー・ノーラン監督（『ダークナイト』『インターステラー』）の最新作『オッペンハイマー』がアメリカで公開されました。7月21～23日という、最初の週末の興行収入は8250万ドル（約117億円）と、科学者の伝記映画としては例外的なヒットとなっています。 内容は、アメリカ陸軍による原子爆弾開発計画「マンハッタン・プロジェクト」のリーダーを務めた物理学者ロバート・オッペンハイマーの半生を描くものですが、単に原爆開発のストーリーだけでなく、非常に複雑な構成が取られています。主人公の半生に加えて、後に「赤狩り」の犠牲者として追及を受けた尋問の様子、さらに彼を陥れた黒幕に対する議会の審議という3つの時間軸がモザイクのように散りばめられ、それぞれが緊張感のある対話劇にな
福澤克雄『VIVANT』 - 青春ゾンビ
TBSドラマ『VIVANT』がおおいに盛り上がっている。個人的には心の1本になるような作品ではないけども、“テレビドラマ”というジャンルを愛好するものとしてはテレビが巻き起こす、この熱狂がとてもうれしい。実際のところ、おもしろいのだ。ツッコミどころ満載ながらも、莫大な予算感の壮大なスケールで黙らされてしまう。このおもしろさと支持のされ方の秘訣は、『VIVANT』に息づく “浦沢直樹”感ではないだろうか。『MASTERキートン』『MONSTER』『20世紀少年』・・・モチーフやルック、謎が謎を呼び伏線を回収していく筋運びなどがどこか似ていて、この国のエンターテインメントの中道とでも言うべき浦沢直樹作品との相似が、『VIVANT』の圧倒的な大衆性を支えているように思う。*1 登場人物たちが常にマージナルな立ち位置を貫いているのもおもしろい。乃木（堺雅人）は、野崎（阿部寛）は、ノーゴン・ベキ（役
PHPで学ぶ Session の基本と応用 / web-app-session-101-2024
PHPカンファレンス関西2024 の登壇資料です。 Cookie を使った Session 管理について解説しています。
変更履歴を記録する
Version 1.1.0 # Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ### Added - v1.1 Brazilian Portuguese translation. - v1.1 German Translation - v1.1 Spanish translation. - v1.1 Italian
ぼくのかんがえたさいきょうのDevOps実現構成
はじめに 昨年、AWS のインフラを運用・監視する上で使いやすいと思ったサービスを組み合わせて構成図を紹介した記事、「【AWS】ぼくのかんがえたさいきょうの運用・監視構成」が投稿したその日の Qiita のトレンド 1 位になり、はてなブックマークのテクノロジー分野でトップを飾りました。（たくさんの方に見ていただき感謝してます！） 本記事では「ぼくのかんがえたさいきょうの運用・監視構成」の続編として「ぼくのかんがえたさいきょうの DevOps 実現構成」を紹介させていただきます。あくまでも「ぼくのかんがえた」なので私個人の意見として受け入れていただけると助かります。 前回の記事でもお伝えいたしましたが、各個人・企業によって環境は違うと思いますし、使いやすいサービスは人それぞれだと思うので、これが正解という訳ではありません。一個人の意見として参考にしてただければ幸いです。 また、こちらの記事
SQL実行の流れ まずはSQLがどのような流れで実行されるのかを見ていきます。 SQL実行の流れは大まかに捉えると以下のようになります。 パーサ パーサでは、ユーザーから送信されたクエリを受け取り、その文法的な正確さを検証します。SQLクエリが正しくフォーマットされているか、必要な構文要素が全て含まれているかをチェックし、例えばFROM句で指定されたテーブルが存在するかどうかも確認します。 文法的なエラーがある場合、例えばカンマの欠落や存在しないテーブルの参照など、クエリはエラーとして返されます。 エラーがない場合は、クエリは「抽象構文木」というデータ構造に変換されます。これにより、データベースはクエリをより効率的に解析し、次の処理ステップに進めることができます。 オプティマイザ SQLクエリがパーサを通過した後、次にクエリの最適化を行うのが「オプティマイザ」です。オプティマイザの主な役割
Blueskyのフォローお願いします！ はじめに まずはこちらをご覧ください。 これは私のApple Watchで計測されたヘルスケアデータです。Apple Watchをつけていると、心拍数や歩数、睡眠時間などのデータが自動的にiPhone内に記録されます。 SREなら健康を維持するためにもSLIとSLOを設定して可視化するべきですよね？ SREなら健康エラーバジェットが無くなりそうだったら「今すぐ寝ましょう！」と架電が来て欲しいですよね？ 普通にやるとiOSアプリを用いて直接ヘルスケアデータを確認することになりますが、Web系のSRE的なエンジニアとしてはやはり業界標準の技術で可視化したいところです。 また、iOSアプリを開発するのは専門知識が必要となり非常に骨が折れる作業です。そもそもMacがないとできないですし。 そこで、今回は Apple Watchのヘルスケアデータを 全自動で良
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ソフトウェアに関わる人が知っておくといいかもしれない法則10個
業務でAWSを利用する時に知っておくべきポイント10選 - Qiita
山下達郎のサンデーソングブックのコメントをゆるく読み解く
界面活性剤と乳化剤、そして乳化について語ろう｜イツキ＠食品メーカーの中の人
【DDD入門】TypeScript × ドメイン駆動設計ハンズオン
東京の大学に進学する彼氏に「代わりに連れて行って」と彼女が渡したうさぎのぬいぐるみのお話がまるで絵本のよう
クリストファー・ノーラン監督の『オッペンハイマー』を日本で今すぐ公開するべき理由
クエリのパフォーマンスチューニングの第一歩。実行計画や統計情報について入門する
ヘルスケアデータをGrafanaで見たくない…？〜健康 Reliability Engineering〜