テクニカルライティングの基本 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 登場人物たちが常にマージナルな立ち位置を貫いているのもおもしろい。乃木（堺雅人）は、野崎（阿部寛）は、ノーゴン・ベキ（役
変更履歴を記録する
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
PHPで学ぶ Session の基本と応用 / web-app-session-101-2024
PHPカンファレンス関西2024 の登壇資料です。 Cookie を使った Session 管理について解説しています。
ぼくのかんがえたさいきょうの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のヘルスケアデータを 全自動で良
はじめに Vimは、そのパワフルなカスタマイズ性と柔軟性で知られており、世界中のプログラマーやテキストエディタ愛好家たちから絶大な支持を受けています。このエディタの真価を引き出す鍵の一つが、autocmd（自動コマンド）機能です。autocmdを用いることで、ファイルの読み込みや保存、さらにはウィンドウのフォーカスが変更されるといった特定のイベントが発生した際に、自動でスクリプトやコマンドを実行することが可能になります。 このガイドでは、autocmdの基本概念から始め、その豊富な応用方法を段階的に解説していきます。初心者でも容易に理解できるように、具体的な使用例を通じて、Vimの作業効率を大幅に向上させる方法をご紹介します。Vimをカスタマイズし、より快適なテキスト編集環境を実現するための第一歩として、このガイドをお役立てください。 autocmdを活用することで、あなたのVim使用経験
「昔好きだった作品」の表現に戸惑ってしまったら？ フィクションが与える2つの影響——文学研究者・小川公代さん こここスタディ vol.19 子どものころ夢中になっていた漫画やアニメ、小説。大人になった今見てみると、当時を懐かしく思う一方で、「男らしさ」や「女らしさ」の表現が目についたり、「セクハラ」や「パワハラ」とも取れるシーンが気になったりしてしまって、昔のように無邪気に楽しめなくなることが増えた。 描かれている振る舞いと、現代の価値観とのギャップに少しでも気づいてしまうと、「私、その作品好きだったんだよね」という言葉さえ、もはや言い出しにくい気持ちになる。時代や自分の価値観が変わった……と言ってしまえばそうだけれど、その作品が好きだった過去の自分さえも否定するようで、どこかさみしい。 私たちは、自分の、あるいは社会の変化を受け止めながらも、かつてのめり込んだ“古い”作品を楽しむことはで
記事：じんぶん堂企画室 近所の公園を散策する柄谷行人さん＝篠田英美撮影 書籍情報はこちら ――1967年３月に東大大学院の修士課程を修了して、最初は国学院大学の非常勤講師として英語を教えていたそうですね。 柄谷 当時は、英文科を出てまず英語の教師になるというのは、よくあるパターンでした。いきなり英文学を教えるというのはなかなか難しいから。実は最初に、ある東大の教授から、ある大学の専任講師の職があるということで、面接に行ったんだよ。ほぼ内定していたらしいんだけどね。週３日授業を持ってくれと言われたので、忙しいから週２日にしてほしい、といった。そしたら、その場でもう「さようなら」ということになってしまった。それを斡旋してくれた教授は、僕のことを怒っていたらしい。 ――メンツ丸つぶれだったんでしょうね。それは、指導教官だった大橋健三郎さんではないんですか？ 柄谷 別の人です。大橋さんは僕のことが
アラサー女子がモヤる…｢不適切にもほどがある!｣に見える"変われない自分を許してほしいおじさん"の甘え セクハラガイドラインは｢それ､上司の娘にもできますか?｣
ドラマ「不適切にもほどがある！」（TBS系）が話題だ。昭和の中年体育教師が令和にタイムスリップして、セクハラ、パワハラなどを槍玉に挙げる「コンプラ」に「気持ち悪りぃ！」と全力でぶつかっていくコメディ。コラムニストの藤井セイラさんは「連続ドラマなので今後のどんでん返しに期待したい。ただ、第3話に出てきた『セクハラのガイドライン』はちょっとマズいのでは……」という――。 「不適切にもほどがある！」の第3話に賛否両論の声 TBSの金曜ドラマ「不適切にもほどがある！」のワンシーンがネットで話題だ。問題の場面は2月9日に放送された。宮藤官九郎脚本のこのドラマ、通称「ふてほど」は、「令和 VS 昭和」のコンプライアンス・ギャップがテーマ。 主人公の市郎（阿部サダヲ）は、体罰上等の昭和の中学教師だ。顧問を務める野球部では「バテるんだよ水飲むと！」と、練習中の水分補給は禁止。ノックをしながら「男のくせにー
ビッグデータ時代の文学研究に何ができるのか？／Ted Underwood 『遠い地平線』序文「文学の地平線の弧」和訳 - digitalnagasakiのブログ
3/15（金）、一橋講堂（千代田区一ツ橋）にて、DHの国際シンポジウム「ビッグデータ時代の文学研究と研究基盤」が開催されます。そこで基調講演をしてくださるTed Underwood先生は、ビッグデータ時代の文学研究に正面から取り組む英文学者として活躍しておられ、2019年、その成果として「Distant Horizons: Digital Evidence and Literary Change」をシカゴ大学出版局から刊行されました。この本の序文は、大変興味深いものであり、膨大なデジタルテキストをにどのように取り組めばよいのか、そして、それによって、人がただ読むだけではうまく見えてこなかった文学の様々な側面、特に文学史やジャンルがどのようにして見えるようになるのか、ということについて、ラディカルな議論と一つの解決の方向性を提示しておられます。本の全体としてはその具体的な方法も示されています
幼い出会いは『源氏物語』のあの名シーン！叫びそうになった『光る君へ』衝撃の1 話を振り返る | アートとカルチャー | クロワッサン オンライン
今年の大河ドラマは『光る君へ』 （NHK／日曜夜8:00〜）。舞台は平安時代、主人公は『源氏物語」の作者・紫式部。1000年前を生きた女性の手によって光る君＝光源氏の物語はどう紡がれていったのか、その過程はどう描かれるのか。ドラマを愛するつぶやき人・ぬえさんと、絵師・南天さんが各話を毎週考察する連載スタートです。 私が平安時代の文化、風俗そして古典文学に興味を持ったきっかけは、子どもの頃に読んだ漫画『あさきゆめみし』（大和和紀）であった。源氏物語がこんなにも面白いのだと知り、図書館で今度は漫画ではない源氏物語の訳本を探して読みふけった。同じく「あさきゆめみし」からそうした道を辿った友達数人と、どの作家の訳本が一番好きかなどを語り合った日々が懐かしい。 少女の私たちを夢中にさせた源氏物語、それを世に送り出した約1000年前の作家・紫式部が今年の大河ドラマ『光る君へ』の主人公である。 私は子ど
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
ソフトウェアに関わる人が知っておくといいかもしれない法則10個
業務でAWSを利用する時に知っておくべきポイント10選 - Qiita
山下達郎のサンデーソングブックのコメントをゆるく読み解く
界面活性剤と乳化剤、そして乳化について語ろう｜イツキ＠食品メーカーの中の人
【DDD入門】TypeScript × ドメイン駆動設計ハンズオン
東京の大学に進学する彼氏に「代わりに連れて行って」と彼女が渡したうさぎのぬいぐるみのお話がまるで絵本のよう
クリストファー・ノーラン監督の『オッペンハイマー』を日本で今すぐ公開するべき理由
クエリのパフォーマンスチューニングの第一歩。実行計画や統計情報について入門する
ヘルスケアデータをGrafanaで見たくない…？〜健康 Reliability Engineering〜
主人公は現代からタイムスリップ？「虎に翼」に違和感 政治的な意図やメッセージ、社会に訴えるためのドラマ使用いかがなものか（夕刊フジ） - Yahoo!ニュース
Vimで自動化を極める：入門者向けautocmdガイド
「昔好きだった作品」の表現に戸惑ってしまったら？ フィクションが与える2つの影響——文学研究者・小川公代さん | こここ
落選がもたらした中上健次との出会い：私の謎 柄谷行人回想録⑦｜じんぶん堂