岩石です。
今日は節分ですね。最近は 恵方巻き や いわし などこの季節になるとTVやスーパーなどで見かけるようになりました。
私が子供の頃は、 豆まき しか知らなかったのですが、いつの間にやら土地土地の風習が全国区になり、習慣となっているのだと思います。
情報が場所に関係なくリアルタイムで流れ、取得できる今の時代、何が流行となるか本当にわかりませんね。
ちなみに、我が家でもこの時期は方角の話題が食卓で出ることがあります。
今回は弊社の社内ドキュメント管理についての話を書きます。
会社などの団体では、組織内に様々なドキュメントが存在します。
これらのドキュメントは役割や権限に応じて、組織内に配布や公開(自由に閲覧できるように)されます。
通常はこういったドキュメントの作成や公開は、オフィスソフト(Microsoft WordやLibre Office Writerなど)を使用し作成し、PDF形式などで公開をされることが多いと思います。
ドキュメントの公開は、専用の文書管理アプリケーションを使われるところや、ファイルサーバで管理されるところ、また紙での配付や掲示が前提の組織もあると思います。
弊社では、収納や閲覧の容易さなどの観点から、紙媒体の情報の保管をできるだけ避けるようにしています。
弊社では、社内ドキュメントの作成に、以前社長の前田が当ブログで紹介した、Sphinxというツールを使用して作成を行っています。
Sphinxの良い点は、まずテキスト形式で記載ができること。作成に使用するツールは自分好みのものが使用できますし、他ツールでの編集も互換性が維持できます。
そして、ドキュメントを分割して作成・編集しそれらをまとめて一つのドキュメントにすることができます。
長くなりがちのドキュメントを章ごとなどでいくつかのファイルに分割して編集し、最終的に一つのドキュメントとして作成することで長いドキュメントも編集が楽になります。
作成されたドキュメントでは、標準で検索機能も提供されますし、ラベルへのリンクや引用なども連携させることができます。
弊社ではSphinxのテキスト形式で編集する特徴を活かし、作成するドキュメントの一連のファイル群をMercurialのリポジトリで管理しています。
※リポジトリ・・・・・情報を体系立てて一元管理する場所のこと
ファイルを管理するリポジトリの形式としてはSubversionやGitなどありますが、弊社では開発プログラムソースコードの管理は、原則としてMercurialで管理しており、ドキュメント類もMercurialで管理しています。
管理に使用するアプリケーションは、Kallitheaというツールで、これも以前前田がブログで紹介しています。
ドキュメントをリポジトリで管理するメリットとしては、
などのメリットがあります。
業務で使用するドキュメントは改版管理・最新版提供が重要です。改版の差分情報や日時が確実に明確にシステムで管理できるため、人がこの部分の管理を行わなくてすむようになりました。
Kallitheaのリポジトリを使用するメリットは他にもあり、最も重要なメリットの一つが プルリクエスト です。
改版管理が業務のドキュメントに必須であることは述べましたが、その改版を誰が承認したかが重要になる書類も多々あります。
弊社ではこの承認活動をプリリクエストという機能で行っています。
プルリクエストとは、リポジトリにファイルの変更を申請し、承認されるとマージして取り込まれるという機能です。 通常はオープンソースソフトウェアなどのプログラムソースコードにおいて、管理権限を持たない方が、改変の提案として送るものです。権限者が良いと判断したら取り込まれ、理由があるなどして否認したら取り込まれないというものです。
弊社では承認が必要なドキュメントは、改版作業を行った後、上位職者などリポジトリの権限を持つものにプルリクエストを送り取り込む様にしています。
これにより、承認の活動自体もシステムで記録されることになります。
承認されたドキュメントは公開が必要ですが、その話はまた私の次回ブログで書こうと思います。
入門Redmine 第6版 出版記念セミナー「Redmine 8年分の新機能ふりかえり」【2024/4/18開催】 入門Redmine 第6版(2024年3月23日発売)に掲載された新機能に関する内容を執筆者・監修者が紹介します。 |
|
My Redmine 初回ご契約で「入門Redmine 第6版」プレゼントのお知らせ Redmineのクラウドサービス「My Redmine」を初めてご契約いただいたお客様にRedmine解説書「入門Redmine 第6版」を進呈いたします。 |
|
2024年度ブランドパートナーに島根県在住のモデル ユイさんを継続起用 ユイさん(モデルスタジオミューズ所属)をファーエンドテクノロジーの2024年度ブランドパートナーとして継続して起用します。 |
|
My Redmine スタンダードプランおよびAdminサポートデスクプランの料金改定のお知らせ【2024年4月ご利用分より】 2024年4月ご利用分より、My Redmine スタンダードプラン(民間企業・個人向け及び官公庁向け)とAdminサポートデスクプランの料金を改定いたします。 |
|
Redmineの最新情報をメールでお知らせする「Redmine News」配信中 新バージョンやセキュリティ修正のリリース情報、そのほか最新情報を迅速にお届け |