チームに無能がいなくなる『メンバー全員で公式ドキュメントを読みあわせる』に感銘をうけた話。 - Qiita
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? これは、同じエンジニアである妻から聞いた話なのですが、彼女の案件で「メンバー全員で公式ドキュメントを読みあわせる」という取り組みがあったそうです。 で、この方法「チーム全体にとって大きなメリットがあるんじゃないか？」と思ったので、共有させていただきます。 「誰も知らない」から「みんな知ってる」に 私は開発職なので、めずらしいことなのかそうではないのか判断がつかないのですが、その案件では、導入対象の製品について詳しい知識を持っているメンバーが一人もいなかったというのです。 誰もその製品をさわったことがなく、とりあえず強そうなメンバーを入れ
ドキュメントや意思決定資料の作成方針 | ツチノコテックアカデミア
ツ社ではGitHubを利用してソースコード管理を行っています。 ドキュメントや意思決定の資料についてもGitHubでできるだけ管理したいと思いますので、以下を基準に作成をお願いします。 Architectural Decision Records (ADRs) アーキテクチャをどうやって決めていったのかの履歴を、ADRとして記録していきます。 各リポジトリの /docs/adr フォルダに格納していきます。 テンプレートを /docs/adr/tpl/ADR.md で用意していますので、コピーして使ってください。 ADRを作っていくことで、担当者が変わった時や、みんなが忘れたころに、「これってどうやって決めたっけ？」を思い出せるようにしていきます。 ツ社は、チャットツールを原則禁止しているので、GitHubのissueやDiscussionにメモがあるかもしれませんが、きちんとした文書を残
ググり時間をぶった切る。AWSを最速で攻略するサイト13選 - Qiita
はじめに 自分がAWSをこれっぽっちも知らない頃、 ググって出てきたどこか知らんサイトからだと、「欲しい情報はこれじゃない」ってのが多くあった。 そんなこと繰り返していると エラー、トラブル時に即対応できない 間違って構築したせいで運用時に悪化してしまう 古いソースコードでエラーがでて動かない これで無駄な時間を過ごすことになる。 要は「ググって得たその情報で、作ったものは正しいのか？」 AWSは常にアップデートされ続ける 欲しい情報を手に入れるまで調べる時間を割くなら、 公式展開してるサイトから得たほうが正確である。 ということで、最速でAWSを攻略するサイトをまとめる。 この記事をブックマークでもしておくと、ググる手間も省けるだろう。 目次 AWSドキュメンテーション AWSサービス別資料 トレーニングライブラリ AWSブログ アーキテクチャーセンター ワークショップをする よくある質
ドキュメントは最強のコミュニケーションツールである――Joelの機能仕様書入門
Joelの機能仕様書とは 有名なソフトウェア技術ブログ『ジョエル・オン・ソフトウェア（Joel on Software）』の著者であり、元マイクロソフトのエンジニアであるジョエル・スポルスキ氏が紹介している仕様書の書き方が、Joelの機能仕様書です（スポルスキ氏本人は、単に「機能仕様書（functional specifications）」と呼んでいます。ここでは、一般的な仕様書と区別するために、この名前を使っています）。 Joelの機能仕様書とは、ひと言で表すと「そのソフトウェアがどのように機能するのかを、ユーザー観点で読みやすくまとめたドキュメントであり、設計者とユーザー（顧客）が仕様を共有し、コミュニケーションするための道具となることを狙った仕様書」です。 Joelの機能仕様書の詳しい書き方は、氏の著書やWebサイト（有志による日本語版）にも無償公開されていますが、最初に公開されてか
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Furoku_CheatSheet_Vim_責