スケールする組織を支えるドキュメンテーションの技術を”GitLab Handbook”から学ぶ｜Anno Takahiro
ドキュメント文化は健全な組織のスケールのために必要 組織の中でドキュメント/文章を残し活用していくことはとても重要だ。クオリティの高いドキュメントがあることで、組織に情報が流通し、透明性を確保できるようになる。情報を流通させるためにいちいち口頭の説明がいらないから、メンバーの数が増えた時でもスケールしやすくなる。過去の結論にアクセス可能になるので、議論を積み上げていき、意思決定のクオリティを高めることにもつながる。そもそも何かを読むということは何かを聞いて教わるよりも時間あたりの処理量が多いし、非同期に実施できる。良いドキュメントをアセットとして社内に蓄積していくことはスタートアップのみならず、ありとあらゆる組織が成長していく上でとても重要であると言える。 しかしその一方で、良質なドキュメント文化を徹底できている会社は多くないように見える。例えば、社内のドキュメントを蓄積させていく場所とし
VP of Technology の星 (@kani_b) です。技術基盤や研究開発領域などを担当しつつ、社内の色々なことを技術の力でいい感じにする仕事をしています。セキュリティや AWS の話が好きです。 さて、みなさんは、ご自身が勤務する会社の就業規則を読んだことはあるでしょうか。 エンジニアに限らず、会社の全スタッフが仕事をする上で関わってくるのが、就業規則や情報セキュリティドキュメントなど、会社のルールや規程を記す文書です。 特にセキュリティやインフラに携わるエンジニアは、その改訂も含め携わったことがある方もいるのではと思います。 よくある文書管理 こうした文書は、以下のように管理されていることが多いようです。 ベースドキュメントは Word 保存時は PDF で保存 版管理は Word の編集履歴 + PDF に保存する際のファイル名 編集は担当部門, 担当者のみが行う かつての
HashiCorp、ドキュメントの作成／レビュー／共有などを容易にする「Hermes」ドキュメントマネジメントシステムをオープンソースで公開
HashiCorp、ドキュメントの作成／レビュー／共有などを容易にする「Hermes」ドキュメントマネジメントシステムをオープンソースで公開 TerraformやVagrantなどで知られるHashiCorpは、「急成長するグローバル企業や遠隔地に拠点を置く企業にとって、書く文化は必要不可欠なものだと考えています（we also believe a culture of writing is a necessity for a fast growing, global, remote-oriented organization.）」として、同社内でも文書による情報共有文化が積極的に行われていると説明しています。 その同社が社内で開発し利用しているドキュメントマネジメントシステム「Hermes」を、オープンソースとして公開しました。 We are pleased to announce th
公文書の取り扱いについて、内閣府が７つの府省庁などで実施された昨年度の監査結果を聞き取ったところ、およそ97％の部署で公文書の管理方法に問題などがあったことが明らかになりました。 それによりますと、内閣官房や内閣府、それに文部科学省などが内部監査を行った170の部署のうち164部署、率にして96.5％の部署で、公文書の管理方法に問題などがあったことが明らかになったということです。 具体的には、公文書のタイトルや保存期間を記した管理簿への記載漏れや記載の誤りなどに加え、公文書の保存期間が満了したあとの取り扱いを決めていない例もあったということです。 また、公文書監察室が11の省庁の出先機関を調査したところ、管理簿への誤った記載などのほか、公文書の保存期間が本来より短く設定されているケースがあったということです。 政府は、24日開かれる公文書管理委員会で、今回の結果を報告することにしています。
政府は今秋からスタートするIT（情報技術）システムのクラウド化をめぐり、人事・給与や文書管理など各省共通の基盤システムを米アマゾン・ドット・コム傘下のクラウド企業に発注する調整に入った。整備・運用にかかる費用は2026年度までで300億円を超える見通しだ。政府は各省庁のシステムについて4～8年で原則クラウドにする方針を打ち出している。コストの大幅減と、最新のデジタル技術の取り込みにつなげるため
2023年10月20日 便利ツール ドキュメント管理ツールとして人気が高まってきているNotion。とにかくたくさんの機能があるので、多岐にわたる使い方ができちゃいます。その中でも今回は書籍の執筆、授業計画（シラバス）作成、論文やレポート執筆など、複数ページの文書管理方法について紹介します。 ↑私が10年以上利用している会計ソフト！ Notionとは？ Notionは多機能ドキュメント作成ツールです。オンライン上でも、インストールしたアプリでも利用できます。 文書作成はもちろん… Trello風のカンバン形式でタスク管理したり… 計算や、ソート、絞り込みのできる表を作ったり… ToDoリストを作ったり… 名簿管理したり… なんでもできちゃいますね！！ Notionの利用料金 Notionは基本無料で利用できます！共有する人数や機能によって月額$4〜の有料プランもあります。 複数ページの文書
大事なデータや思い出として残しておきたい映像・音声は、クラウドサービスやHDDに保存する方法の他、CDやDVD、Blu-rayディスク(BD)といった光ディスクの記録媒体に保存しておくケースも多くあります。このような光ディスクはコンパクトで管理や配布もしやすい一方で、かつて主に記録媒体として使用されたVHSは情報が15年～20年で劣化して消えてしまう「磁気メディア危機」を迎えたように、光ディスクもデータの劣化・損失が起こる可能性があります。そのような劣化や損失が起こる要因などについて、カナダ保存研究所(CCI)が解説しています。 Longevity of Recordable CDs, DVDs and Blu-rays — Canadian Conservation Institute (CCI) Notes 19/1 - Canada.ca https://www.canada.ca/
株式会社ラクスが開催するエンジニア向けのイベント「RAKUS Meetup」。今回は「SaaS新規プロダクトの技術」をテーマに、先行技術検証やアーキテクチャの選定を担当する鈴木勇氏が登壇し、「LADRのすすめ＆先行技術検証プロジェクトの紹介」という内容で話をしました。 LADRのすすめ 鈴木勇氏（以下、鈴木）：それでは私、鈴木が発表したいと思います。『新サービス立ち上げ時の技術選定と、サービス立ち上げに向けたラクスの取り組み（仮）』だったのですが、長いので『LADRのすすめ＆先行技術検証プロジェクトの紹介』といった内容でやりたいと思います。 まずは自己紹介ですが、私は鈴木勇と言います。2013年にラクスに中途入社しました。会社の肩書きはガンプラ部部長です。先行技術検証やアーキテクチャ選定、技術イベントの司会などをやっています。今日は司会はやりません。 上流から下流まで経験済みで、一応プロジ
このような方におすすめです • 属人化を解消したい • ベテラン社員のノウハウを継承したい • バラバラな業務品質を標準化したい • ナレッジマネジメントの進め方を知りたい ナレッジ共有のメリット 属人化の防止、業務の質のアップ ナレッジ共有することで、属人化を防ぎ、社員による共有が簡単にできることから社内業務の質のレベルアップができます。 業務の効率化 情報やナレッジを一元管理することで情報を見つける時間を大きく減らせ、またその情報やナレッジを活用することで重複する業務時間を大幅に減らせることから業務を効率化できます。 人材教育コストや業務の引き継ぎコストの低減 新入社員やキャリアアップ研修や転勤、部門異動による引き継ぎには大きなコストがかかりますが、ナレッジ共有することでコストを低減できます。 社内wikiはなぜ情報共有ツールとして便利なのか？4つのメリット 組織パフォーマンスを向上さ
「森友学園」をめぐる国有地の売却問題で、情報公開請求に対し、財務省が「不開示」としていた行政文書およそ5,600ページをテレビ東京が入手しました。 入手した文書は、国有地売却をめぐる国会答弁のために政府が用意した想定問答や財務省の近畿財務局が財務省本省や国土交通省の大阪航空局との間でやり取りした文書など合わせて5,600ページに上ります。 この文書は立憲民主党の川内博史議員の情報公開請求に対し、財務省が「不開示」とすることを決定していたものです。 しかし、ことし6月、総務省の「情報公開・個人情報保護審査会」が、財務省の判断は「違法」であり、「決定を取り消すべきだ」としたことから、開示に踏み切ったとみられます。 川内議員：「今まで出ている資料とつきあわせて真実はどこにあるか探っていきたい」。 しかし、新たに公開された応接録や交渉記録は、日付や一部の担当者の名前を除き、その多くが黒塗りとなって
Indian startup Zypp Electric plans to use fresh investment from Japanese oil and energy conglomerate ENEOS to take its EV rental service into Southeast Asia early next year, TechCrunch has…
はじめに GitHubでレポジトリを作成すると最初に作成されるREADME.md。 デフォルトのまま放置していたりしませんか？ README.mdはレポジトリの顔です。 ここを整えておくことで、レポジトリのクオリティをぐっと上げることができます。 しかし、README.mdに何を書いたらいいのか、わからないという人も多いと思います。 この記事ではおすすめの構成をまとめます。 README.mdの読者はだれか？ まず、誰に向けてREADME.mdを書くのかというところから考えることから始めましょう。 README.mdの読者は大きく分けてユーザと開発者の２種類います。そのレポジトリを閲覧するひとはユーザが多いのか、開発者が多いのかを想定してどちらをメインで書くか決めると良いでしょう。 README.mdは英語で書くべき？ 有名OSSはすべて英語でREADME.mdが書かれているため、当然英語
社内文書を GitHub で Git 管理すると、版管理がしやすかったり、レビューによって変更点を関係者が見られたりといろいろ便利なので、最近社内の一部文書を GitHub に移行しています。 また、先日 Cookpad 開発者ブログで Markdown と GitHub で社内規程を便利に管理 という記事が公開されました。 https://techlife.cookpad.com/entry/2019/06/26/182322 きっとうちに限らずいろんなところでエンジニアが非エンジニアに GitHub をポチポチする方法を教えたりしているかもしれないと思ったのでまとめます。 エディタを使わずコマンドも打たない、github.com 上でファイルの編集から Pull Request を作るまでを完結させる方法です。なるべく非エンジニアもわかるように書いたつもりですが、なにかあれば編集リクエ
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Markdown と GitHub で社内規程を便利に管理 - クックパッド開発者ブログ
“公文書管理に問題あり” ７府省庁などの97％の部署 | NHKニュース
政府クラウド、アマゾンに発注へ 人事・文書管理などの基盤システム - 日本経済新聞
Notionで複数ページの文書管理がはかどる！執筆、授業計画、レポートにもおすすめ！
CD・DVD・BDが劣化する要因や種類ごとの寿命についてカナダ保存研究所が解説
導入した記録ではなく導入“しなかった”記録を残す LADRによるアーキテクチャ意思決定記録のすすめ
【2024年版】ナレッジ共有ツール タイプ別おすすめ 10選
独自 財務省「森友文書」5,633枚入手：ゆうがたサテライト：テレビ東京
TechCrunch | Startup and Technology News
イケてるレポジトリのREADME.mdには何を書くべきか - Qiita
社内文書管理はGitHubで！非エンジニアのためのGitHub講座 - Qiita