jj for chromium

jj is a Git-compatible version control system. It is not yet officially supported by ChOps, but may be in the future.

This directory contains documentation and configuration to support jj in chromium.

Getting started

Join the mailing list. This is very important, as this is how we will communicate important information. Note that this is not an official group.
Follow go/jj-in-chromium (only currently open to googlers). Further instructions will be added later which also support external contributors.
Optional: Try the official jj tutorial or the unofficial one

Using chromium with jj

Working with commits

Most commands for working locally with commits work just fine. The one exception to this is that Git submodules are not yet supported by jj.

This means whenever you see jj say "ignoring git submodule" (generally only when you switch between submitted commits), you will need to run gclient sync.

Syncing code

jj sync (using the config in tools/jj/config.toml)

If a sync (or any other operation) results in a conflict, you can resolve the conflict by directly editing the conflicted file(s) and/or using jj resolve.

If you would like to look at the pre-conflict state of a change (e.g. for a pre-jj dormant branch) you can use jj evolog -r <revision> to find its last unconflicted revision (e.g. <change_id>/10).

Uploading code

jj upload (using the config in tools/jj/config.toml)

Presubmits

Currently manual (git cl presubmit)

Running formatters

jj fix (using the config in tools/jj/config.md)