Movatterモバイル変換

[0]ホーム
URL:

はてなブックマークアプリ

サクサク読めて、
アプリ限定の機能も多数！

アプリで開く

はてなブックマーク

  • はてなブックマーク
  • テクノロジー
  • 社内ドキュメントはなぜ更新されないのか？情報の鮮度を最小限の運用負荷で維持する「イミュータブルドキュメントモデル」のススメ - KAKEHASHI Tech Blog
  • Twitterでシェア
  • Facebookでシェア

気に入った記事をブックマーク

  • 気に入った記事を保存できます
    保存した記事の一覧は、はてなブックマークで確認・編集ができます
  • 記事を読んだ感想やメモを書き残せます
  • 非公開でブックマークすることもできます
適切な情報に変更

エントリーの編集

loading...

エントリーの編集は全ユーザーに共通の機能です。
必ずガイドラインを一読の上ご利用ください。

タイトルガイドライン

このページのオーナーなので以下のアクションを実行できます

タイトル、本文などの情報を
再取得することができます
コメントを非表示にできますコメント表示の設定

ブックマークしました

ここにツイート内容が記載されますhttps://b.hatena.ne.jp/URLはspanで囲んでください

Twitterで共有

ONにすると、次回以降このダイアログを飛ばしてTwitterに遷移します

833usersがブックマークコメント85

    ガイドラインをご確認の上、良識あるコメントにご協力ください

    0/0
    入力したタグを追加

    現在プライベートモードです設定を変更する

    おすすめタグタグについて

      よく使うタグ

        社内ドキュメントはなぜ更新されないのか？情報の鮮度を最小限の運用負荷で維持する「イミュータブルドキュメントモデル」のススメ - KAKEHASHI Tech Blog

        ガイドラインをご確認の上、良識あるコメントにご協力ください

        0/0
        入力したタグを追加

        現在プライベートモードです設定を変更する

        おすすめタグタグについて

          よく使うタグ

            はてなブックマーク

            はてなブックマークで
            関心をシェアしよう

            みんなの興味と感想が集まることで
            新しい発見や、深堀りがもっと楽しく

            ユーザー登録

            アカウントをお持ちの方はログインページへ

            記事へのコメント85件

            • 注目コメント
            • 新着コメント
            y_as
            “社内ドキュメントはなぜ更新されないのか？”そんなもん評価されない（報酬がない）からだよ。カイゼン一件につき500円みたいな工場が話題になったことあるけど同じように報酬出せば更新の奪い合いになると思う。

            その他
            Dursan
            日本にPDCAってマジで少なくって、PDPDPDPDPDPDPDとしかやってない。

              その他
              jtw
              その価値を経営者が認めていないから更新されないだけ。稼働も評価（給与）も与えずに、なぜ更新されると勝手に思い込むのか。

                その他
                Flume
                上位コメにあるようにやっても評価されないのと、あとは自分のタスク以外に興味無い（チーム全体の生産性考えない）人が殆どだからじゃないかな。

                  その他
                  ntstn
                  こういうのこそAIにやってもらいたい

                    その他
                    bufferings
                    おもしろかった！僕の中ではプロジェクトのときに書くドキュメントと、その積み重ねとして更新し続ける最新仕様ドキュメントがあるんだけど、似た感じだよね。言葉の定義も好きだな。嬉しい。

                      その他
                      htnmiki
                      厳密には「評価されないから」ではなく「参照されない」からかなあ。使われないものはメンテされないし、それで回ってるなら不要なドキュメントだったということ。

                        その他
                        WildWideWeb
                        問いと答が釣り合ってない印象。そう思ったのは文脈が与えられてないから。「自分がそれをするインセンティブがないとみんなが思ってるから」という読み手が一応思いつきそうな答とは異なる前提での問いかけだった。

                          その他
                          pixmap
                          ドキュメントもGitで管理すればいいだけでは？ドキュメントはミュータブル、イベント（コミット）はイミュータブルって自然に分離できるよ。「なぜ更新されないのか」の直接の答えにはならないけどね。

                            その他
                            manaten
                            ドキュメント類、ゲームのwikiが本文でリソース情報、更新情報でイベント情報がきれいにまとまっており、更には関連単語という形でリレーションもされていて非常に読みやすいので、どうにか真似できないかと思ってる

                              その他
                              satosssi
                              考え方としておもしろかった

                                その他
                                okbm
                                仕様書をgithubで管理して差分を見ながら開発するのめっちゃ楽だった。書く人のコストめっちゃかかるけど

                                  その他
                                  endo_5501
                                  “より俯瞰的なドキュメントが必要だと感じたら(かつ、まだ力尽きていなければ)、それらをまとめてPRDやDesign Docsとしてドキュメント化する” そう、「力尽きてなければ」

                                  その他
                                  razokulover
                                  ちゃんと管理する責任者を作らないからだとドキュメントライティングの本に書いてあった

                                    その他
                                    mallowlabs
                                    “ストック情報の中にも、実は「ミュータブル(可変)な情報」と「イミュータブル(不変)な情報」の二つがある”

                                    その他
                                    tmatsuu
                                    うっ。はい。

                                      その他
                                      arajin
                                      “まず小さな意思決定をイベント情報としてドキュメント化し、次にそれらの積み重ねを参照することでリソース情報やより抽象的なイベント情報をドキュメント化する”　課内のwikiつくって、似たようなことやってた

                                      その他
                                      tsubosuke
                                      更新されないと業務的に困るものなら更新せざるを得ないし、更新されないならそれは更新必要ないってことなのでは。

                                        その他
                                        codenote
                                        GitHub repositoryでドキュメントを管理するのオススメです🧑‍💻

                                          その他
                                          sho
                                          GitHub上でPRベースでドキュメント管理してれば自然とこうなるじゃん

                                            その他
                                            sippo_des
                                            pdcaのcてcancelですので、皆さんご存知ないと思いますが、、 それはそれとて認知度の低い資料の多いとこよ

                                              その他
                                              hetarechiraura
                                              重要な仕事だと思って更新したけど評価されなかった経験があるからこそ、こういう反応が多いんじゃないっすかね…😇／そもそも俺の人生にとって勤労そのものが重要じゃないんだが？？？誰に、何にとっての重要？

                                                その他
                                                MacRocco
                                                メモ

                                                  その他
                                                  sp_ice
                                                  良いコンセプト！ドキュメントを統制する人が不在の現場を経験したが、必要なものが最新化されてないから付け焼き刃で作った資料だらけになってて辛かった。参照される資料は最新化されると思ってるなら甘い。

                                                    その他
                                                    tkys0628
                                                    “個別の意思決定ごとに、「承認された日」「背景」「決定されたこと」「決定による影響」のみをドキュメント化する より俯瞰的なドキュメントが必要だと感じたら(かつ、まだ力尽きていなければ)、それらをまとめてPRD

                                                      その他
                                                      nunulk
                                                      "なぜ更新されないのか？"―要らないから。とはいえ、仕様を決めるときは Slack、会議では Notion に議事録を取る、チケット管理も Notion でやってリンクを張る、とかがいまんとこマイベストかな

                                                      その他
                                                      kent4989
                                                      残念ながら共感は出来なかった。ただうまくいっていないことだけは確かなので、何かの突破口は見つけたいところなんだけど。

                                                      その他
                                                      takilog
                                                      更新されないドキュメント、いらないんじゃないの？

                                                        その他
                                                        mujisoshina
                                                        一般に社内ドキュメントは更新されるべきなのか？を考えると、放置されているものは使われていないから更新の必要もないのが殆どだと思う。まずはドキュメントを有効活用して参照数を上げる取り組みが先なのでは。

                                                          その他
                                                          otihateten3510
                                                          イミュータブルドキュメントの考えはいいと思う。良い提案。

                                                            その他
                                                            PrivateIntMain
                                                            今どうなっているかも大事だけど、それ以上に「これはどうあるべきものか」「そうなっていないなら何がネックなのか」の2点だけでも押さえているとだいぶ違う。

                                                              その他
                                                              mmaka2787
                                                              議事録は集中して聞いて内容理解しないと書けないしWFは全体と細部理解しないと書けないし、どちらも作成に技術が必要で、かつ、なくても殆どの場合一定程度まで問題が生じないのでコスパが悪い。

                                                                その他
                                                                natu3kan
                                                                コールセンターのナレッジみたいに仕事の度に回答の根拠として見て使うの必要で、間違いや古い情報に気が付いて更新せざるを得ない業務でもないと、更新しなかったことに責任が生じにくい上に更新コストが厳しい。

                                                                その他
                                                                sds-page
                                                                なんかの機会でチェックした時に更新してなかったら怒られるけど普段は誰も見ないし定期的に更新しても評価に繋がらない。手法を云々する以前の問題

                                                                その他
                                                                syu-m-5151
                                                                具体的な施策に落とし込んで継続して向上させ続けるのが本当に難しい。なぜなら、社内ドキュメントと読むだけの人は年々増えていくので…

                                                                  その他
                                                                  ledsun
                                                                  理由は簡単、ドキュメンテーションの訓練を受けてないから。ほとんどの人は、一般的な技術文書を書く訓練も、その会社または組織でどんなドキュメントをどうやって書くのかも説明を受けた記憶がないはず。

                                                                    その他
                                                                    chikurou
                                                                    レビュー対象に入ってないから。

                                                                      その他
                                                                      onesplat
                                                                      …で？具体的にどうすればいいの？え？終わり？

                                                                        その他
                                                                        NikugaTabetainoyo
                                                                        ほー

                                                                        その他
                                                                        tamtam3
                                                                        更新されない社内ドキュメントなんてぶっちゃけ作るだけ無駄。会議の議事録だって誰も見ない。その日決まった事、やった事、問題点、課題、明日の予定を箇条書きにし、タグをつけた業務日報の方が未だ使い勝手がある

                                                                          その他

                                                                          注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の「建設的コメント順位付けモデルAPI」を使用しています

                                                                          リンクを埋め込む

                                                                          以下のコードをコピーしてサイトに埋め込むことができます

                                                                          プレビュー
                                                                          アプリのスクリーンショット
                                                                          いまの話題をアプリでチェック！
                                                                          • バナー広告なし
                                                                          • ミュート機能あり
                                                                          • ダークモード搭載
                                                                          アプリをダウンロード

                                                                          関連記事

                                                                            usersに達しました！

                                                                            さんが1番目にブックマークした記事「社内ドキュメント...」が注目されています。

                                                                            気持ちをシェアしよう

                                                                            ツイートする

                                                                            社内ドキュメントはなぜ更新されないのか？情報の鮮度を最小限の運用負荷で維持する「イミュータブルドキュメントモデル」のススメ - KAKEHASHI Tech Blog

                                                                            はじめに こんにちは。カケハシの各プロダクトを支えるプラットフォームシステムの開発チームでテックリ...はじめに こんにちは。カケハシの各プロダクトを支えるプラットフォームシステムの開発チームでテックリードを担当しているkosui(@kosui_me)です。 プロダクト開発の世界では、明瞭な社内向けドキュメントを書くための方法が数多く提案されてきました。読者の中には、製品要求を明瞭にするためにPRD (Product Requirements Document、製品要求仕様書) を書き、プロジェクトの背景から全体の設計やその代案について明瞭にするためにDesign Docsを書き、アーキテクチャに関する意思決定の記録を明瞭にするためにADR(Architecture Decision Record) を書いてきた方も数多くいらっしゃると思います。 しかし、どんな素晴らしいドキュメントも、何故か更新されなくなります。新メンバーへのオンボーディングのためにインフラ構成図を検索したあなたが見つけた

                                                                            ブックマークしたユーザー

                                                                            • ularaka2025/03/11ularaka
                                                                            • mayu_01212025/02/12mayu_0121
                                                                            • STR512024/09/20STR51
                                                                            • s20h11m2024/09/17s20h11m
                                                                            • kfly82024/09/07kfly8
                                                                            • o9bYGFqG2024/09/01o9bYGFqG
                                                                            • ikngtty2024/08/17ikngtty
                                                                            • umbra2024/08/16umbra
                                                                            • enmtknt2024/08/16enmtknt
                                                                            • satosssi2024/08/15satosssi
                                                                            • techtech05212024/06/18techtech0521
                                                                            • nakkisan2024/05/15nakkisan
                                                                            • quodius2024/04/01quodius
                                                                            • lulichn2024/02/11lulichn
                                                                            • basilic2024/01/31basilic
                                                                            • masaru03052024/01/01masaru0305
                                                                            • yuki_ropp2023/12/26yuki_ropp
                                                                            • nishitki2023/11/28nishitki
                                                                            すべてのユーザーの
                                                                            詳細を表示します

                                                                            ブックマークしたすべてのユーザー

                                                                            同じサイトの新着

                                                                            同じサイトの新着をもっと読む

                                                                            いま人気の記事

                                                                            いま人気の記事をもっと読む

                                                                            いま人気の記事 - テクノロジー

                                                                            いま人気の記事 - テクノロジーをもっと読む

                                                                            新着記事 - テクノロジー

                                                                            新着記事 - テクノロジーをもっと読む

                                                                            同時期にブックマークされた記事

                                                                            いま人気の記事 - 企業メディア

                                                                            企業メディアをもっと読む

                                                                            はてなブックマーク

                                                                            公式Twitter

                                                                            はてなのサービス

                                                                            • App Storeからダウンロード
                                                                            • Google Playで手に入れよう
                                                                            Copyright © 2005-2025Hatena. All Rights Reserved.
                                                                            設定を変更しましたx
                                                                            [8]ページ先頭
                                                                            ©2009-2025 Movatter.jp