タグ

githubとdocumentに関するopparaのブックマーク (2)

  • 規程文書を Google ドキュメント から GitHub に移行する - KAYAC Engineers' Blog

    人事部の小池です。 この記事は KAYAC Advent Calendar 2022 の16日目の記事です。 カヤックの規程文書管理の仕組みを Google ドキュメント から GitHub に移行した取り組みについて紹介します。 これまでの文書管理 カヤックでは長年規程文書を Google ドキュメント で管理していました。Google ドキュメント は多くの従業員にとって親しみやすいものの、文書を管理する上でいくつかつらい点がありました。 改訂内容の差分が追いにくい・改訂の背景がわからない Google ドキュメント なので変更履歴から過去の版を閲覧することは可能ですが手軽とはいえません。改訂の際は内容以外にも改訂に至った経緯、議論といった背景も重要ですが、これらの背景は成果物である Google ドキュメント の版の履歴からは伺うことはできません。「ある時までは確かこういった規程内容

    規程文書を Google ドキュメント から GitHub に移行する - KAYAC Engineers' Blog
  • オープンソースドキュメント翻訳プラットフォームとしての GitHub (React 日本語ドキュメントの例)

    はじめに ひょんなことから React 公式ドキュメント日語版のメンテナをやらせていただいています smikitky です。 この記事は、React 公式ドキュメントの翻訳作業が GitHub ベースでどのように行われているのかを解説したものです。ドキュメントの翻訳には色々な方法がありますが、React の現アプローチは非常に上手く行っていると個人的に考えています。部分的には似たアプローチを説明している既存記事も探せばありますが、少し詳しめに書くことで事前の不安を取り除き、「思ったより簡単そうだから、自分もあのライブラリのドキュメント翻訳をやってオープンソースに貢献してみよう」と思えるようになることを目標にしています。 想定読者は GitGitHubMarkdown(ないし類似の軽量マークアップ言語)、および基的な HTML の仕組みがわかる開発者です。何らかの静的サイトジェネレー

    オープンソースドキュメント翻訳プラットフォームとしての GitHub (React 日本語ドキュメントの例)
  • 1