[B! git] moronbeeのブックマーク

設計ドキュメント腐る問題、Git管理で運用してみた結果 | フューチャー技術ブログ

はじめにTIG真野です。秋のブログ週間2023 の3本目は、設計ドキュメントをGit管理して腐らせないようにがんばってみた話をします。前段として6年前、﹁我々はいかにシステム開発におけるドキュメント腐る問題と戦えば良いのか﹂という記事を書いたのですが、その後の試行錯誤はどこにも残していないことに気づきました。普段のフューチャー技術ブログですとちょっと引け目を感じるテーマですが、秋の夜長を楽しむため読み物成分を多めに書くというテーマのこのブログリレーにピッタリな気がするため、この機会をお借りします。ドキュメントも色々な種別があるかと思いますが、この記事では設計ドキュメントを指すことにします。設計ドキュメントは開発メンバーが参照するもので、ステークホルダーへの説明資料に引用して使うことはあれど、主目的は異なるという前提です。Design Docの場合もありますし、システム構成図、ERD、

moronbee 2023/11/02

リンク

ロジカルなコミットメッセージの書き方

チーム開発におけるコミットメッセージの書き方についてアウトプットします。コミットメッセージに正解はありません。組織によって最適な手法は異なるため、参考のひとつにしてください。要点フォーマット :Emoji: Title / Reason / Specification / Issue 項目 Emoji - 内容・種類をひと目で分かるように Title - タイトル（概要） Reason - このコミットをする理由 Specification - 言い訳ではなく、このコミット内容になった意図や仕様など Issue - 対応するIssue 作業内容はコードを見ればわかるので、「概要」「変更理由」「意図・仕様」を簡潔にまとめる。例コミットメッセージを書く理由そもそも、コミットメッセージを書く理由は以下の通りです。ひと目でどんなコミットなのか判断するため簡潔にコミット内容を説明す

moronbee 2023/05/15

リンク

初学者の私がGitを理解するために、この順番で読めばよかったと思った記事の順番 - Qiita

エンジニア未経験のわたしがGitを学ぶ上で、この流れで記事を読むべきだったと思ったことを記載する。完全に初学者意見のため、疑いながら読んでください。私は下記の流れで学習することによって、理解をしやすいように感じた。 ①　Gitで何をしているかのイメージを掴む︵コマンドなし︶ ②　Gitのイメージを、コマンドで実現している記事をみる ③　実際にGitのコマンドを打ちながら、出力と、頭の中のイメージのすり合わせGitで何をしているかのイメージを掴む︵コマンドなし︶こちらの記事は、Gitのイメージをコマンドなしで、わかりやすく図で示してくださっています。記事にも記載されていますが、・重要なのは﹁何﹂から﹁何﹂へ・﹁どんな作業﹂を行うのかを追う・操作前と操作後でどんなことが起こっているのかをイメージする上記の内容が、すごく同意で、重要だと感じている。いきなりコマンドを打ちながら

moronbee 2023/04/30

git
tutorial

リンク

Git で競合ファイル一覧を楽に見る方法 - Qiita

競合ファイル一覧を楽に見る方法は、あまりないようで。設定ファイルに書くのが一番よさそうです。コマンドの場合

moronbee 2022/06/08

リンク

gitで特定のファイルの更新を禁止する - Qiita

プロジェクトによっては、そう安々と変更してほしくないファイルが有ったりします。そこで、特定のファイルの変更をコミット出来なくするGitフックの紹介です。例えば、.htaccessとlibディレクトリ配下の全てのファイルの変更を禁止するには以下の様なpre-commitフックを作成します。 .git/hooks/pre-commit #!/bin/sh unchangeable_files=( ^\\.htaccess$ ^lib/.* ) containsElement () { local e for e in "${@:2}"; do [[ "$1" =~ $e ]] && return 0; done return 1 } for FILE in `git diff --cached --name-status $against -- | cut -c3-`; do if con

moronbee 2020/05/08

リンク

tigでgitをもっと便利に！ addやcommitも - Qiita

皆さん、tigコマンドを活用していますか？ tigは、コンソール上で使えるgitブラウザです。実はずっと、ただのきれいなgit logだと思っていたのですが、本当はそんなことはありません。かなり使えるやつなのです。インストールソースコード: https://github.com/jonas/tig インストール方法: https://github.com/jonas/tig/blob/master/INSTALL.adoc この辺りを参考にしてみてください。詳細は割愛します。基本の使い方この状態の差分を扱っていきます。いつものこれだとこんな感じ。git logが素敵にビジュアライズされてます。この画面をmain viewといいます。ここでエンターを押すと、下半分に差分の詳細︵diff view︶が表示されます。下矢印で、Unstaged changesの差分を見てみるとこんな

moronbee 2018/10/24

git
tig

リンク

GitFlowをやめて本番リリースが楽になった話 - Qiita

背景サーバーサイド開発のプロジェクトでGitFlow(的な)運用を行っていたが、本番リリースの際に困ることがあったのでgitの運用フローを変えて解消したという話。まず問題の内容から順番に書いているので、結論(新しい運用ルール)だけ知りたい人はこちらgit運用フローについては、GitFlow・GitHub Flow・GitLab Flowなどが有名だがどれとも少し違うように思ったのでまとめた。 <2018/06/10追記> 新フローにも名前が欲しいと思っていたが、同じやり方を﹁GitFeatureFlow﹂と呼んでいる記事を見つけた。個人的にもしっくり来たのでこれからはこの呼称を使っていこうと思う。 cf. GitFlowは使わない！シンプルな﹁GitFeatureFlow﹂を紹介します </追記終わり> 導入プロジェクトの概要採用するべき運用ルールはプロジェクトの条件にも依ると思う

moronbee 2018/05/14

developが本当の共同開発中ブランチになってて何を担保しているのか不明...。元のフローのまま featrueを検証用サーバーにアップできる運用にした方がいいのでは？

git
git-flow

リンク

【今日からできる】コミットメッセージに「プレフィックス」をつけるだけで、開発効率が上がった話 - Qiita

はじめに今まで commit message を「なんとなく」書いていたが、プレフィックスをつけることで、コミットメッセージに対する考え方が変わった。そのおかげで開発効率が上がったので、その内容をシェア。プレフィックスをつけるってどういうこと？以下のようにコミットメッセージの先頭に、なんらかの文字をつけること。 feat: xxx という機能を追加 fix: yyy で発生するバグを修正 refactor: zzz の機能をリファクタのように feat, fix, refactor などがプレフィックスです。最近 OSS の Contribution Guide などでよく見かけます。導入したプレフィックスルール Angular.js/DEVELOPERS.md Angular.js の開発者ガイドに書いてあるメッセージを参考にしました。以前のコミットメッセージ（例ちなみ

moronbee 2018/01/31

https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#type

リンク

gitで便利なエイリアス達 - Qiita

これはGit Advent Calendar / Jun. - Qiita.16日目の記事です．私はエイリアスが好きなのでgitまわりのエイリアスについて書いてみます．間違ってたらすみません，指摘してくださると嬉しいです．設定方法いろんなスコープにエイリアスを設定できます．例としてgitstでgit statusを実行できるようにしてみましょう．設定ファイルに書き込む方法と，git configコマンドで設定する方法があります．設定ファイルに書く場合は以下のようにaliasセクションに短縮形 = 展開形の書式で書きます．どの設定ファイルに書くかで適用される範囲が変わります．また，コマンドで設定する場合は，git config [option] alias.短縮形展開形を実行します．マシン全体に反映させる場合 $(prefix)/etc/gitconfigに書くか，以

moronbee 2017/09/27

tree = log --graph --date=short --pretty='%ad%C(auto) %h%d %Cgreen%an%Creset %s'

git
graph

リンク

gitのmerge --no-ff のススメ - Qiita

2015年も終わりになって、gitの基本的な使い方の話に更なる需要があるとは思っていないのですが本日が私のAdventCalender担当日であることと、本日偶然遭遇したトラブルの都合上、もしかしたらまだ需要が微レ存かもしれないと思い記事を書いていきたいと思います。まとめ皆しとくといい。 git のデフォルト設定はどうなっているか gitはデフォルトではmergeコマンドを使った際に、mergeコミットを発生させる必要がない場合mergeコミットを発生せずにmergeを行うfast-forwardでのmergeを行うようになっている。 --no-ffというオプションを付けることで意図的にfast-forwardを行わないコミットをすることが出来る。どういうトラブルが起こるか仮にmasterにtopicAブランチをmergeしたとする。 fast-forwardであるmergeの場

moronbee 2017/09/27

リンク

Learn Git Branching

A interactive Git visualization tool to educate and challenge!

moronbee 2017/01/26

git
tutorial

リンク

GitHub - agis/git-style-guide: A Git Style Guide

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

moronbee 2016/12/01

git
style

リンク

Gitのコミットグラフを可視化できるGitGraph.jsがおもしろい - Qiita

プレゼン資料を作っている時に﹁このコミットグラフをMarkdownかテキストで書けたらな﹂と思ったことがある人、結構いるのではないでしょうか。GitGraph.js を使うと、JavaScriptで記述したコミットログをcanvasを使って可視化できることを知りました。なかなかおもしろいです。準備まずGitGraph.js の JavaScript と CSS ファイルを読み込みます。GitHub からソースをcloneするなり、bowerを使うなり、CDNを使うなり、お好みで。ここではコミットグラフを定義するコードも別ファイル index.js に書くことにします。 <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>GitGraph.js</title> <link rel="stylesheet" type=

moronbee 2016/10/03

git
graph

リンク

【翻訳】Gitをボトムアップから理解する

John Wiegleyさんの "Git from the bottom up" を翻訳しました。元PDFはこちらからダウンロードできます‥ http://newartisans.com/2008/04/git-from-the-bottom-up/ 元記事のライセンスがクリエイティブコモンズのBY-SAであったため、この翻訳もBY-SAとなります。ライセンスを守って自由にご利用ください。︵詳しくは記事内の最初にも書いてあります︶翻訳ミスの指摘や改善の提案等があればブログコメントやTwitter(@oshow)などで遠慮なくどうぞ。Git をボトムアップから理解する Wed, 2 Dec 2009 by John Wiegley 私がGit を理解しようと調査した時、高級なコマンドの視点から眺めるよりボトムアップ式に理解することが役立った。そしてボトムアップ視点で見るGit が

moronbee 2016/09/29

git

リンク

powerful-code.com-蒙城县郭侠熟食有限责任公司-网站

moronbee 2016/09/16

git pull --rebase

git

リンク

初心者でもわかる！リベースの使い方を解説します | 株式会社LIG(リグ)｜DX支援・システム開発・Web制作

こんにちは、エンジニアの王です。今回は、Git初心者を悩ませるリベースについて解説してみたいと思います。リベースが初耳リベースを聞いたことはあるけど、使っていない不安を抱えながらも、リベースをなんとなく使っている上記に当てはまる方は、ぜひ読んでくださいね。リベースで何ができる？コミットが綺麗になる！　以上です！　この一言に尽きる！具体的にどのように綺麗になるかというと…… コミット履歴がわかりやすくなるコミットメッセージを後から変えるコミットの順序を後から変える2つ以上のコミットを1個に統合する一度コミットした内容を編集するといった具合でしょうか？　整理整頓が好きな方は、ぜひリベースを使いこなしていただきたいと思います！マージとリベース2つのブランチの変更点を統合するとき、Gitの最も一般的なやり方は、マージとリベースを使うことです。マージは初回で説明したので、

moronbee 2016/09/16

"リベース（rebase）とは、「re+base」でベースとなるブランチを変えるということ"

git
rebase

リンク

ぼくが実際に運用していたGitブランチモデルについて

オペレーションとかインフラ系のエンジニアリングからは少々離れそうなので、個人的な備忘録がてら、Gitのブランチモデルについて。淡々と書くよ。見えないチカラ: A successful Git branching model を翻訳しました基本的に、このA successful Git branching model︵上記は翻訳記事︶を参考にしています。ですが、完全ではありません。運用しながら都合よく省略していますし、悪く言えば曲解もしています。あくまで、わたしが都合良く解釈して取り回した結果と考えてください。さて、このようなドッシリとしたブランチモデルが、あらゆる規模のプロジェクトに対して有効であるかといえば、もちろんそうではありません。コツコツ個人で開発しているライブラリなどは、ブランチを使わなくても良いケースがあるでしょうし、作ってもバージョン番号ブランチぐらいのケースだってザラ

moronbee 2016/09/16

リンク

gitにおけるコミットログ/メッセージ例文集100

私はコミットログの書き方に悩む英語の苦手な人間である。実際、似たような人は世の中に結構いるようで、頻出単語を集計したりまとめたものは既にあって役に立つのだけれど、これらはあくまで単語の話であり、具体的な文を構成する過程でやっぱり困る部分がかなりあった。要するに、どういう時にどういう文が使われているのか、ということを示した例文集が欲しいのである。ググると他にも﹁例文集があればいいのに﹂みたいな声はあるくせして、しかし誰も作ろうとしない。何なんだお前ら。それじゃ私が楽できないじゃないか。仕方なく自分でまとめたので、増田に垂れ流しておく。はじめにここで挙げているコミットログは全て実際のコミットログからの転載である。当然ながら各コミットログの著作権はそれぞれの書き手にある。いずれも各英文でググれば出てくるし、フェアユースの範囲なら許してくれるだろうと考え名前とプロジェクト名は割愛したが、ここ

moronbee 2016/07/26

git
commit

リンク

VimとGitの効率的なコラボレーションの仕方 - MyEnigma

わかばちゃんと学ぶ Git使い方入門〈GitHub、Bitbucket、SourceTree〉posted with カエレバ湊川あいシーアンドアール研究所 2017-04-21 Amazonで探す楽天市場で探すYahooショッピングで探す目次目次はじめに Gitのコンフリクトをvimdiffでマージするセットアップ参考資料 git連携用vimプラグイン: vim-fugitive インストール Gstatusが凄く便利何かわけがわからなくなって、コミット時までソースを戻したい時ブランチ名をvimのステータスラインの表示するソースコードのGitHubページを一瞬でブラウザで開くコミットする pushする HEADとのdiffを表示する参考資料 MyEnigma Supporters はじめに gitは最近のソフトウェア開発には必須だと思いますが、 VimとGitを

moronbee 2016/07/11

git
vim

リンク

GitHub - tpope/vim-fugitive: fugitive.vim: A Git wrapper so awesome, it should be illegal

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

moronbee 2016/07/11

git
vim

リンク

はてなブックマーク

タグ

関連タグで絞り込む (35)

gitに関するmoronbeeのブックマーク (62)

お知らせ

今週のはてなブックマーク数ランキング（2024年7月第1週）

月間はてなブックマーク数ランキング（2024年6月）

今週のはてなブックマーク数ランキング（2024年6月第5週）

公式Twitter

キーボードショートカット一覧

はてなブックマーク

公式Twitter

はてなのサービス