Markdown と GitHub で社内規程を便利に管理 - クックパッド開発者ブログ

VP of Technology の星 (@kani_b) です。技術基盤や研究開発領域などを担当しつつ、社内の色々なことを技術の力でいい感じにする仕事をしています。セキュリティや AWS の話が好きです。 さて、みなさんは、ご自身が勤務する会社の就業規則を読んだことはあるでしょうか。 エンジニアに限らず、会社の全スタッフが仕事をする上で関わってくるのが、就業規則や情報セキュリティドキュメントなど、会社のルールや規程を記す文書です。 特にセキュリティやインフラに携わるエンジニアは、その改訂も含め携わったことがある方もいるのではと思います。 よくある文書管理 こうした文書は、以下のように管理されていることが多いようです。 ベースドキュメントは Word 保存時は PDF で保存 版管理は Word の編集履歴 + PDF に保存する際のファイル名 編集は担当部門, 担当者のみが行う かつての

[gachapining]

こういうバックオフィスも巻き込み最適化していける会社は総合力が高い。エンジニアがツールを勧めても、バックオフィスの人が拒否反応を示して、オフィスやスプレッドシートのままであることは多い気がする。

[gigi-net]

就業規則にPR出せて便利

[sho]

むしろCookpadがまだこうなっていなかったことが驚き。GitHubがWeb上で編集可能になったのはだいぶ前だし。

[Eiichiro]

早くビジネス文書管理のデファクトスタンダードになってほしい。

[kijtra]

一度挑戦しようとしたんだけど、図がやりにくくて、図で一発理解なものを文章にすると読みたい文章じゃなくなる。あと印刷しにくい点と、文書どうしの並び順管理とか、そこらへんどうしてんだろ。

[mztnex]

こんなこともやってます（社内の情報セキュリティガイドブックも同じ運用をしていて便利）

[sora_h]

id:sho この取り組み自体は実は結構前(1〜1.5年くらい?)。障壁はエンジニア職によらない全社員へのGitHub Enterpriseアカウント付与で、それが達成されてから動きだしたのでした。

[borerere]

クックパッドエンジニアがすごいアピールすごいけどサービスがつらい

[TakamoriTarou]

よく考えると法律もプレーンテキストだから、社規定もこの形がよい

[mirai-iro]

先進的で素晴らしいし、法務などのバックオフィス的な部署もITエンジニアリングに馴染んでいて「ITエンジニアにとって働きやすい会社」というよいアピールになっている (なお弊社)

[blue_night_blue]

業務マニュアルに、これいいかも。

[diet55]

「あれ、これって…？」……Wiki？（爆）

[ryo_n574]

前職の引き継ぎ資料はGithub Wikiでまとめたんだけど、正解だったと思う

[progrhyme]

こういうのやりたい

[kw5]

いいな〜

[lesamoureuses]

“ルールそのものに対する提案も Pull Request として来るものが生まれており、議論しやすくなった”

[Songmu]

めちゃくちゃ良いし弊社でもやっていきたい。

[mrkn]

うらやましい。GHE だからやれるんだと思う。

[braitom]

ほんとこれ。“そもそも、そこまで頑張って整えている体裁は本当に必要…？”ルールの提案もPRでできるのめっちゃいいな。

[kzm1760]

羨ましい

[Gonzoo]

うちもこうしたいなぁ。羨ましい

[shiopon01]

クッパの就業規則、公開はされていないんすね

[raimon49]

バックオフィス系の社員も巻き込めるのつよい。

[studio_graph]

みんなでGitHub使ってます

[ysk-ur]

つよい

[kuroko_otomo]

社内の規則を改定しない、クソ会社には必要ないみたい。でも、markdownは最高

[omr14]

ワード辛いわかる

[t_motooka]

社内規定も契約書も定款も株主総会議事録も、git管理+mdからの整形が良いですぞ。

[call_me_nots]

“GitHub の Branch Protection を使い、責任者の Approve がなければマージできないようになっている”

[atro]

これ導入したいんだよ

[light940]

技術系じゃない文書とかドキュメントもGitHubで管理した方が効率良い場合は多々ありそう。 こうゆう感じで非エンジニアに対しても積極的にGitHub使っていくスタイルは良い！

[fashi]

版管理だけでなくプルリクとマージまで活用するとは

[Kuichi]

プレーンテキストは色々な環境で見られるし、スタイルがつけられない分管理もしやすいなあと常々思っている（WordとExcelに悩まされることが結構あるので…）

[esocchi]

ウチのPLはgitが使えないというのに

[yatta47]

この取り組み、ドキュメント作成で取り組み始めた。