| # 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 |
| 1. Join [the mailing list](https://groups.google.com/g/chromium-jj-users). This |
| is very important, as this is how we will communicate important information. |
| Note that this is not an official group. |
| 2. Follow go/jj-in-chromium (only currently open to googlers). Further |
| instructions will be added later which also support external contributors. |
| 3. Optional: Try the |
| [official jj tutorial](https://jj-vcs.github.io/jj/prerelease/tutorial/) or |
| [the unofficial one](https://steveklabnik.github.io/jujutsu-tutorial/) |
| |
| ## 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`) |
| |
| ### 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`) |
