Arcanist Workflows

Updated 4,367 Days AgoPublic

Actions

Descriptions of Arcanist workflows.

Official epriestley Workflow

This is how I use arc with Git.

I use an amend/rebase mutable-history workflow where each idea is always represented by one commit. I never make checkpoint commits, and I never write Git commit messages, and I never merge. I have two shell aliases:

• wip: ("work in progress") git commit -a -m WIP
• squish: git status && git commit -a --amend -C HEAD

I use TextMate to edit code. The mate commands below invoke the editor, although I usually locate and open files with GUI in the Finder.

To start a new change, I work in feature branches.

$ git checkout master
$ git checkout -b newfeature
$ mate somefile.php
$ wip
$ arc diff

To update a change, I amend it into HEAD.

$ mate somefile.php
$ squish
$ arc diff

To start a new feature which depends on another feature, I branch off the branch. I do this rarely.

$ git checkout newfeature
$ git checkout -b newerfeature
$ mate newfile.php
$ wip
$ arc diff

To pull in other users' changes to a first-degree branch, I rebase. I do this very rarely.

$ git rebase master

To rebase an nth-degree branch, I cherry-pick. This is usually painless, while using rebase often isn't.

$ git checkout newerfeature
$ git show # copy commit hash
$ git reset --hard newfeature
$ git cherry-pick <hash>

To push a change, I use arc land:

$ arc land newfeature