情報の見つけやすさを追求する - 社内ドキュメンテーションの階層整理術 - KAKEHASHI Tech Blog
カケハシのプラットフォームチームでソフトウェアエンジニアをしているすてにゃん (id:stefafafan) です。今回はチームに配属されて数ヶ月の私が、いかにして社内ドキュメンテーションの階層構造を整理し、情報の検索性を向上させたかについてお話します。 はじめに この記事の想定読者 課題意識 メンバーへの共有と相談 社外事例の調査 esa の階層整理 第 1・第 2 階層の整理 ストック情報とフロー情報を意識した階層の整理 esa の機能をフル活用する 効果や今後について はじめに カケハシでは全社的にドキュメンテーションツールとして esa - 自律的なチームのための情報共有サービス を利用しています。それぞれのチームやプロダクトごとに階層を切ってドキュメントを書いています。 プラットフォームチームでは認証基盤などの社内プラットフォームシステムを開発しているため、自チームが運用する各種
「主語を抜き、理由を省き、具体例を考えない”言語化をサボる人”は信用しない方がいい」…生産的な議論ができないし、コミュニケーションコストが高い
マグ @OnebookofMAG 10代の頃に教わった「主語を抜き、理由を省き、具体例を考えない”言語化をサボる人”は信用しない方がいい」という言葉、そっくりそのまま私の信念に変えて大事にしている。こういう人と仕事をすると「生産的な議論」ができない。「話せばわかる」が成立しない。何より、コミュニケーションコストが高い マグ @OnebookofMAG ちなみに「言語化をサボる人」は、テキストコミュニケーションで顕著にでる。SlackやLINE然り、プライベート感は行間の想像を楽しむコミュニケーションでいいけど、ビジネス面では「察して」は独りよがりかつ、わがままの押し付け。文章を書くのは大変だけど、行間を正しく読むのはもっと大変。 x.com/OnebookofMAG/s… マグ @OnebookofMAG 令和の”人当たりの良さ/コミュニケーションの上手さ”は、電話口や対面で出るものではな
今日から始める「システム監視」。大量トラフィックのシステムを安定して運用する知見をアソビューのSREに学ぶ - Findy Tools
公開日 2024/08/16更新日 2024/08/15今日から始める「システム監視」。大量トラフィックのシステムを安定して運用する知見をアソビューのSREに学ぶ はじめにアソビュー株式会社では、アソビュー！という電子チケットを販売するサイトを運営しています。 システムを安定稼働させるためには、日常的にシステムの状態を監視して、問題があれば調整するというプロセスを繰り返すことが必要不可欠です。本記事では、アソビュー株式会社において、どのような体制でこの安定稼働を実現しているかということを書くことによって、同じようにシステムを安定稼働させたいと日々考えておられる方々を想定読者として、そのノウハウを共有しようと思います。 安定稼働をするために必要な要素 人間の健康管理のために必要なことシステムを安定稼働するために必要なことというのは、人間が健康に生きていくためにやっておいたほうがいいことと共通
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
