Lambda の運用面でのベストプラクティスを学べる「AWS Lambda Operator Guide」を読んだ - kakakakakku blog

2023/05/08 158 users サーバーレスアプリケーション AWS Lambda 運用面

AWS の公式ドキュメント「AWS Lambda Operator Guide」を読んだ❗️AWS Lambda を軸にサーバーレスアプリケーションを構築するときに意識しておくべき "運用面のポイント・ベストプラクティス" がまとまっていて，とても良いドキュメントだった👏 内容的には AWS Well-Architected Framework: Serverless Applications Len... 続きを読む

良いドキュメントを書きたくなる本を読んだらドキュメンタリアンになりたくなった - じゃあ、おうちで学べる

2023/03/14 445 users SRE 役職 書評 ドキュメントライティング ドキュメント

ドキュメンタリアンとは、役職に関係なく、ソフトウェア業界でドキュメントとコミュニケーションに関心を持つ人のことです。 www.writethedocs.org はじめに これは主に『ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング』の書評です。私は所属しているSreake事業部でSREをして... 続きを読む

ドキュメントを書くときの「メンタルモデルの原則」 - クックパッド開発者ブログ

2020/11/27 32 users メンタルモデル Jasper ドキュメント 原則 マニュアル

こんにちは。クリエイション開発部の丸山@h13i32maruです。 みなさんドキュメント書いてますか？私はドキュメントを書くのは結構好きです。最近もプライベートで開発しているJasperというGitHub用Issueリーダーのユーザ向けドキュメント（マニュアル）を書きました。でも良いドキュメントを書くのって難しいですよね。 ... 続きを読む

ドキュメントの構造化による，良いドキュメントの作成方法：新春特別企画｜gihyo.jp … 技術評論社

2016/01/03 122 users ドキュメント 本稿 gihyo.jp 新春特別企画 性質

あけましておめでとうございます。 ソフトウェアを開発し公開する場合， ドキュメント （マニュアル） を作成することが求められます。しかし， 良いドキュメントを作成する方法というのはあまり知られていません。どのようにすれば良いドキュメントを作成できるのでしょうか？ 本稿では， ソフトウェアと同じくドキュメントを要素と性質に構造化することで， 良いドキュメントを作成する方法を紹介します。そして， その... 続きを読む