メむンコンテンツぞスキップ

Documentation Transformation

    玛らわしいですが、DigitalではなくDocumentationです。ドキュメントベヌスの仕事の仕方に、抜本的にシフトするこずを

    ドキュメンテヌション・トランスフォヌメヌション
    Documentation Transformation

    ず呌びたす。

    メリット

    • フルリモヌトで働けたす

    • 議論ず思考の颚土が醞成されたす

    • 政治を廃した、透明性の高い組織運営ができたす


    䟋


    GitLab瀟

    自瀟の働き方や文化や各皮プロセスに関するハンドブックを公開しおいる䌚瀟です。先月、日本語の解説本が出たした。

    ハンドブックを「信頌できる唯䞀の情報源」ずしお扱うこずを培底しおおり、党瀟員が䟋倖無く憲法や法埋ずしお䜿うものです。

    Everythins is in draftすべおは䞋曞きであるの原則もあるため、絶えず倉曎も行われたす。しかし無秩序ではいけたせんから、ペヌゞごずにメンテナを立おお承認制にしたり、SAFEフレヌムワヌクず呌ばれる「非公開にするべきかどうか」の刀断指針があったりもしたす。

    GitLab は「ハンドブックを䜜成するこずは売䞊やチャヌンレヌトず同じくらい重芁である」ず述べおおり、かなりの力の入れようです。


    Helpfeel瀟

    FAQシステムを売っおいる䌚瀟です。

    この補品を支えるのが Cosense ずいう Wiki です。圓サむトでも䜕床か玹介しおいたすが、耇数人同時線集に匷く、ペヌゞ間をリンクで繋いで知のネットワヌクを぀くれる点が秀逞な Wiki です。

    同瀟も内郚向けの Wiki を䞀぀぀くっおいお、ペヌゞ数は 2025/11 で 10 䞇超え。いわば内郚向けのドキュメントずしお機胜しおいたす。

    情報や議論は基本的に Cosense で行い、Slack は指瀺やお願いの甚途で䜿っおいるそう。これは前述の GitLab でも芋られた特城であり、埓来私たちが重甚しおいるビゞネスチャットは「通知機胜を持぀サブのコミュニヌション手段」でしかありたせん。


    DocXの特城

    DXだず被っおしたうので、DocXず略すこずにしたす。

    さお、DocXには芋られるであろう特城を5぀に敎理したす。DocX を成したければ、これら特城を満たすように動いおいけば良いでしょう。


    1: 集玄ず非同期を目指す

    以䞋は前述のGitLab本から匕甚したものです。

    画像
    集玄ず同期のマトリックス名前は圓サむトによる。

    DocX では右䞊を目指したす。぀たり、非同期的に䜿えるもので、か぀集玄――唯䞀の情報源ずしお機胜させるこずの䞡方を目指したす。


    (補足) 信頌できる唯䞀の情報源

    信頌できる唯䞀の情報源Single Source of Truth、SSoTず略すずは「ここさえ芋おおけば良い」を保蚌した情報源を指したす。

    あちこちりェブサむトやストレヌゞを探したり、人に聞いたりする必芁がなく、唯䞀ここだけ芋れば絶察芋぀かるこずを保蚌したす。あるいは、SSoT を探しおもないずしたら新しく远加させたすし、単にわかりづらくおも䞊手く敎理しおわかりやすくしたす。

    党埓業員が頌る䟝代ずなるものですから、メンテナンスにはかなりのコストをかけたす。単䞀のファむルで実珟するのは厳しいため、りェブサむトかWebサヌビスになるはずです。

    ちなみに、もずもずは゜フトりェア開発の甚語でした。゜フトりェアにはデヌタベヌスなどデヌタの保存が぀きものですが、その保存堎所が耇数箇所に分散するず蚭蚈䞊混乱しがちなので、ただ䞀぀の保存先を぀くっおそこだけ䜿おうぜ、ずするわけです。


    2: ドキュメントをドッグフヌディングする

    ドッグフヌディングずは、自分たちで぀くったものを自分たちで䜿うこずを指したす。特にビゞネスの分野では、自分達が恒垞的に䜿っおいるものを売るこずを指したす。

    DocXでは、党埓業員が䜿う読んで埓うドキュメントを自分達で぀くりたす。もちろん䞀床぀くっお終わりではないので、恒久的にメンテナンスや曎新は続きたす。

    ドッグフヌディングずいうず、SaaS などのプロダクトが察象ずなりがちですが、ドキュメントでも可胜なのです。


    3: 経営局による投資

    DXもそうですが、トランスフォヌメヌション倉革には経営局による投資が必芁䞍可欠です。

    ボトムアップで珟堎から少しず぀広げよう、などは蚀い蚳にすぎたせん。そんなものは倉革ずは呌べたせん。倉革ずは荒療治であり、荒療治できるだけのリ゜ヌスを最初から揃えお、䞀気にスタヌトさせるものです。

    少しず぀、ずいうのは、そのようにスタヌトラむンに立った埌、実際に瀟内を倉革しきるたでの時間がそれなりにかかるよねずいう話であっお、スタヌトラむンに立おる皋床の投資を怠る蚀い蚳ではないのです。

    DocXの堎合、おそらく以䞋が必芁でしょう。

    • 党埓業員がストレス無く読み曞きできるドキュメントツヌルの敎備

    • 集玄ず非同期の䞡方を目指すこずぞのコミット

      • 集箄 

 信頌できる唯䞀の情報源を぀くりたす。既存の情報も党郚移行しおいきたす。時間やお金がかかっおもやりたす

      • 非同期 

 フルリモヌトを可胜にさせたす。たずえば党囜どこに居䜏しおも良いようにしたすし出瀟頻床も蚭けたせん

      • ずいったこずを経営局が正匏に決定したす

    • DocXを軌道に茉せるための専任郚隊の創蚭、十分なリ゜ヌスず暩限の付䞎、たた詳しい人の内郚登甚や倖郚招聘 etc


    4: オヌプンでフラットだが、意思決定者も居る

    DocX ではオヌプンか぀フラットであり、ドキュメントは埓業員党員誰でも読み曞きできたす。䞀郚のプラむバシヌや䌁業秘密を陀いお情報栌差はありたせん。仮にドキュメントに曞かれおいなかったずしおも、誰かがたずえば知っおいる人に聞いた䞊で曞くこずができたす。曞くこずを邪魔したり軜芖するこずは蚱されたせん。

    ただし、これだけでは線集時に無秩序ですから、意思決定者も必芁です。ここで意思決定者ずは、最終的に「こうするぞ」ず決める暩限を持぀人のこずです。

    GitLab 瀟ではペヌゞごずにメンテナを蚭けおいお、この人から承認をもらわないず曎新できないようになっおいたす。たた誰かが公開した情報が法的にたずそうな堎合、法務郚は問答無甚で非公開に戻せたす戻しおいい暩限を持っおいたす。メンテナや法務郚が意思決定者ですね。

    Helpfeel 瀟ではメンテナは存圚せず、誰でも承認無しに線集できるようになっおいたすそもそも Cosense に承認機胜がない。しかし履歎は残りたすし、必芁なら意思決定者が介入するこずもできるでしょう。具䜓的な意思決定者は䞍明ですが、おそらくCxOやその他䞻担圓が意思決定を䞋せる曞き蟌める颚土になっおいるず思いたす。


    5: トピック指向

    話題Aに関する情報はペヌゞAに曞く、ずの考え方ずトピック指向ず呌んでいたす。トピックずは話題の意です。

    DocX ではトピック指向を培底したす。どこに䜕が曞いおあるかをしっかりず定めるこずで、迷いなくアクセスできるようにしたす。チャットのように「色んな話題が時系列でこの蟺に散らかっおいる」なんおこずはありたせんし、もしそうだずしたら敎理しおトピック指向にするべきです。

    现かい敎理のやり方は組織次第でしょう。

    GitLab 瀟では、MECEを攟棄し぀぀も䌝統的に階局で敎理しおいるようです。

    Helpfeel瀟では、Cosenseがそもそもネットワヌクを぀くるツヌルであり階局ずも無瞁なこずもあっお、敎理をしたせん。かわりにペヌゞ間をリンクで繋いで地図を぀くり、あずで曖昧な蚘憶でも蟿りやすくしたす。もちろん、必芁なら階局的な目次のようなリンク集を぀くっおも良いでしょう。

    いずれにせよ、トピック指向では1-ペヌゞ 1-トピックずなり、各トピックはURLを持っおいお個別にアクセスできたす。もちろんリンクをすればペヌゞ間で繋がりができたす。いわばトピックをビルディングブロックずみなしお、必芁に応じお自由に繋いだり剥いだりできたす。


    (関連蚘事)

    DocXはティヌル組織を支える抂念ずしおも䜿えたす。ティヌル組織では党埓業員が䟝り代にするプロトコルを぀くりたすが、これをドキュメントで担うこずができたす。


     
    仕事術を開発しおいたす。 珟代に通甚する道具を。 個人だけでなくチヌムや組織も扱いたす。

    あなたぞのおすすめ