はじめにTIG真野です。 秋のブログ週間2023 の3本目は、設計ドキュメントをGit管理して腐らせないようにがんばってみた話をします。 前段として6年前、「我々はいかにシステム開発におけるドキュメント腐る問題と戦えば良いのか」という記事を書いたのですが、その後の試行錯誤はどこにも残していないことに気づきました。普段のフューチャー技術ブログですとちょっと引け目を感じるテーマですが、秋の夜長を楽しむため読み物成分を多めに書くというテーマのこのブログリレーにピッタリな気がするため、この機会をお借りします。 ドキュメントも色々な種別があるかと思いますが、この記事では設計ドキュメントを指すことにします。設計ドキュメントは開発メンバーが参照するもので、ステークホルダーへの説明資料に引用して使うことはあれど、主目的は異なるという前提です。Design Docの場合もありますし、システム構成図、ERD、
Sapling is a new Git-compatible source control client. Sapling emphasizes usability while also scaling to the largest repositories in the world. ReviewStack is a demonstration code review UI for GitHub pull requests that integrates with Sapling to make reviewing stacks of commits easy. You can get started using Sapling today. Source control is one of the most important tools for modern developers,
緊急新人エンジニア応援企画！ ということで自分が Git のエイリアスとして設定している便利コマンドを紹介していく。 直前のコミットに追いコミットする (git fixit) git commit --amend --no-edit もろもろ整えて git push しよう、とすると「あっちょっと修正したい」となるのはよくあること。その際いちいちコミットメッセージを書いて rebase するかというとそんな面倒はとりたくなく、一撃で終わらせたい。--no-edit でコミットメッセージを編集せずに --amend できる。 git fixit に設定している。git commit の引数をそのまま受け付けるので、git fixit -a や git fixit <file> のように使える。 メインブランチに戻る (git com) f() { remote_head=$(git symb
昔はファイルサーバー＋アップデート担当者、それから次の時代はCVS、今はSubversionを使っています． Subversion以前は、ほぼプログラムの置き場程度の使い方、作り方だったのですが、さすがに今ではそんな管理ではとても開発の現場の動きについてゆけません．このため、 基本的には受託の顧客単位のリポジトリがあり リポジトリには/trunk、/branches、/tags があります． およその使い方のルールは以下のようなものです． 顧客からの依頼/開発コンポーネント毎にブランチを切って、開発はそこで集中的に行います．開発が終わってメンテナンスフェーズに入れば、/trunkにマージします． しかし、現在運用しているプログラムで不具合報告が上がれば、/trunkからブランチを切って、そこで障害対応を行い、修正完了できれば/trunkにマージします． あとプログラム開発の単位をバージョン
米インテルは、マイクロンと共同開発した新しい不揮発性メモリ「3D XPoint」を採用したサーバ向けSSD「Optane SSD DC P4800X Series」を発表しました（動画などを見るかぎりOptaneはオプテインと発音するようです）。 従来のSSDには不揮発性メモリとしてNAND型フラッシュメモリが使われていることが一般的でした。今回のOptane SSD DC P4800X Seriesに採用された3D XPointは、アクセス速度においてNAND型フラッシュメモリよりも最大で1000倍高速で、しかも耐久性も最大1000倍あると発表されています。 そのため3D XPointは「ストレージクラスメモリ」と呼ばれる、メインメモリでありながらストレージのように大容量かつ不揮発であるという新しいメモリ用途に使われることが期待されています。 ストレージクラスメモリが実用化されると、メイ
english セマンティック バージョニング 2.0.0 概要 バージョン番号 MAJOR.MINOR.PATCH を前提として、 あなたが互換性のない API の変更を行うときに MAJOR バージョンを、 後方互換性のある方法で機能性を追加したときに MINOR バージョンを、 そして、後方互換性のあるバグ フィックスをしたときに PATCH バージョンを、 インクリメントします。 追加のラベルとして、プレリリースとビルド メタデータが MAJOR.MINOR.PATCH フォーマットへの拡張として利用することができます。 序論 ソフトウェア マネジメントの世界には「依存関係地獄」と呼ばれる非常に恐ろしい場所が存在します。 あなたのシステムがより大きくなるほど、あなたのソフトウェアの中へより多くのパッケージを溶け込ませるほど、いつかこの絶望の底にいるあなた自身に気づく、そんな可能性が
Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? これは Git (や Subversion などのバージョン管理システム) にコミットする時により良いコミットメッセージを書くための提言です。この提言は特にメッセージの一行目だけを対象とします。せめて最も重要な一行目だけでも良いメッセージを書いて欲しいからです。提言をズバリ一言で表すと 一行目には要求仕様を書け です。 背景 プロジェクトによっていろいろ慣習の差はあるものの、一般的には「コミットメッセージの一行目は変更内容の要約を簡潔に書け」とされます。特に Git は、各コミットメッセージの一行目だけを取り出してそれを一覧表示するなど
GitHubは各自がリポジトリを持つ分散型ソースコード管理システムになっています。そして各自が差分を受け取ることでコラボレーションを実現しています。 同じような仕組みをデータについても行おうとしているのがDatです。まだはじまったばかりのプロジェクトではありますが非常に興味深いソフトウェアになります。 インストールはnpmを使って行いますので簡単に完了します。 $ npm install dat -g インストールが完了したら、最も基本的な使い方を試してみます。 $ mkdir foo $ cd foo $ dat init これで初期化が終わります。Gitに似ていますね。次にデータを追加します。 # 一例 $ echo '{"hello": "world"}' | dat --json # CSVからも可能 $ cat some_csv.csv | dat --csv データの読み込みは
10月18日、diffビューア/マージツール「Meld 1.8.2」がリリースされた。Subversion 1.6関連の不具合を修正するなどの強化が加わっている。 Meldはファイルの差分をグラフィカルに表示できるdiffツール。WindowsおよびMac OS Xに対応する。ファイルやディレクトリ同士の比較のほか、GitやBazzar、Mercurial、Subversionなどのバージョン管理ツールとの連携も可能。また、差分のマージを支援する機能や3方向での比較、リアルタイムでのファイル比較、自動マージモードなどの機能もある。 Meld 1.8.5は9月に公開した1.8系の最新安定版となる。Subversion 1.6レポジトリ選択時のリグレッションが修正されたほか、WindowsのUnicodeユーザー名のバグも修正された。これにより、Meldの設定はリモートからローカルのapp d
0分―― 分散型バージョン管理システム「Git」とは ソフトウェア開発ではソースコードを作成しながらソフトウェアを作り上げていきますが、バグの修正や機能の追加ごとにソースコードの状態を記録し、それぞれのバージョンを管理することが必要になります。 そういったソースコードを管理するソフトウェアが「バージョン管理システム」であり、複数人でのソフトウェア開発において必要不可欠なソフトウェアとなっています。
Plastic SCM を開発したCodice Softwareが，セマンティックマージツール (Semantic Merge Tool) のプレビュー版をリリースした。このツールはコードを解析することで，行単位で比較する多くの同種ツールよりも正確なマージを行うことができる。同社の主席ソフトウェア技術者であるPablo Santos Luaces氏に話を聞いた。 InfoQ: セマンティックマージに注目するようになった，そもそものきっかけは何だったのでしょうか？ Pablo: かなり以前のことですので，本当に長い話になります。 実は私たちには，"優れたブランチは優れたマージから" という信念があるのです(笑)。 要するに "タスクごとのブランチ" (http://codicesoftware.blogspot.com/2010/08/branch-per-task-workflow-exp
ソフトウェア構成管理（SCM: Software Configuration Management）についての入門となる資料を公開します。 ソフトウェア構成管理周りについては、過去に バージョン管理とソフトウェア構成管理の関係 変更依頼管理ってなんぞや？ ソースコードを扱う単位（１） 構成管理は誰のためのもの？ デグレードへの根本的な対応 ソフトウェア構成管理の記事を連載します バグ管理についての記事を執筆しました。 プロセスの変更管理 ケント ベック氏のアジャイル開発における開発支援ツールの役割についてのホワイトペーパー と紹介してきました。 今回は、特定のご要望にお応えする目的で、バージョン管理の講演のために資料を作成しましたが、もともとバージョン管理だけすることに ROI 的な効果を感じていない（バージョン管理は、それだけをやろうとすると難しい面もあります）ので、ソフトウェア構成管理
ソフトウェア開発に関しては、これまでほぼ一人で完結していた*1ので git の運用方法もかなり適当だったのですが（ただのコミットマシーン状態）、今回、同一プロジェクトに対して複数人でコミットしていく形になっているので、その状態だとやはりまずいなと言う気がしてきました。ググっていると「なるほど」と思う記事もたくさんあったので、それらの記事を元に自分のプロジェクトの「git の運用指針」を情報共有のために記載しておこうと思います。 前提 まず始めに、現在のプロジェクトの状況は下記のようになっています。 開発は 1 人のメインコミッタ（私）と数人のサポートコミッタ（アルバイト等）で行われる メインコミッタはフルタイム、サポートコミッタは週に数時間〜10時間程度の勤務形態 サポートコミッタに対しては、基本的に 1 機能（1 チケット）を 1 人で完結するように作業を配分するが、時間的な兼ね合いもあ
The entire Pro Git book, written by Scott Chacon and Ben Straub and published by Apress, is available here. All content is licensed under the Creative Commons Attribution Non Commercial Share Alike 3.0 license. Print versions of the book are available on Amazon.com. The version found here has been updated with corrections and additions from hundreds of contributors. If you see an error or have a s
Still need help? The Atlassian Community is here for you. Ask the community You can specify repositories at the following levels in Bamboo: global – repositories are available to all plans in Bamboo.plan – repositories are available to all jobs in the Bamboo plan.job – repositories are available to all tasks in the Bamboo job.The recommended approach is to set up linked source repositories at the
SourceTreeはWindows/Mac OSX用のGit/Mercurialクライアントです。 個人的にはGitリポジトリを操作する時にはターミナルで行っているのですが、やはりGUIの方が便利という人も多いはずです。そこでWindows/Mac OSX双方で使えるGit/MercurialクライアントのSourceTreeを紹介します。 リポジトリ一覧です。 リポジトリブラウザ。グラフや説明、編集したユーザなどが一目で分かります。 SourceTreeは日本語ローカライズも行われており、リポジトリに対する操作は上にボタンが並んでいるので一目で分かるようになっています。コミットやチェックアウトといった日常的な処理もSourceTreeから簡単にできます。さらにGitもMercurial（Hg）も変わらずに操作できるのが魅力です。 SourceTreeはWindows/Mac OSX用の
キーボードショートカット一覧 j次のブックマーク k前のブックマーク lあとで読む eコメント一覧を開く oページを開く ✕
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
