Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

meta: cement "Jujutsu" (呪術) as the project name #3042

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 8 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,12 +21,12 @@

## Introduction

Jujutsu is a powerful [version control system](https://en.wikipedia.org/wiki/Version_control)
for software projects. You use it to get a copy of your code, track changes
to the code, and finally publish those changes for others to see and use.
It is designed from the ground up to be easy to use—whether you're new or
experienced, working on brand new projects alone, or large scale software
projects with large histories and teams.
Jujutsu (呪術 _Jujutsu_) is a powerful [version control
system](https://en.wikipedia.org/wiki/Version_control) for software projects.
You use it to get a copy of your code, track changes to the code, and finally
publish those changes for others to see and use. It is designed from the ground
up to be easy to use—whether you're new or experienced, working on brand new
projects alone, or large scale software projects with large histories and teams.
Comment on lines +25 to +29
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I just went ahead and reflowed this paragraph, but the only actual real change is showing the kanji and romanized spelling.


Jujutsu is unlike most other systems, because internally it abstracts the user
interface and version control algorithms from the *storage systems* used to
Expand Down Expand Up @@ -118,9 +118,8 @@ And it adds several innovative, useful features of its own:
[undo-history]: https://en.wikipedia.org/wiki/Undo#History
[conc-safety]: https://martinvonz.github.io/jj/latest/technical/concurrency/

The command-line tool is called `jj` for now because it's easy to type and easy
to replace (rare in English). The project is called "Jujutsu" because it matches
"jj".
The command-line tool is known as `jj`, making it easy to type and easy to
remember (rare in English).

Jujutsu is relatively young, with lots of work to still be done. If you have any
questions, or want to talk about future plans, please join us on Discord
Expand Down
53 changes: 53 additions & 0 deletions docs/FAQ.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Frequently asked questions

## General Technical Questions

### Why does my branch not move to the new commit after `jj new/commit`?

If you're familiar with Git, you might expect the current branch to move forward
Expand Down Expand Up @@ -179,6 +181,57 @@ directory.

We hope to integrate with Gerrit natively in the future.

## Other Questions

### What's does the name _Jujutsu_ mean, and where does it come from?

When Martin von Zweigbergk originally started the project, it was named
"[Jujube](https://en.wikipedia.org/wiki/Jujube)" after a type of fruit. This
name is what actually gave rise to the lovable and short name `jj` for the
command line tool. Later on, the the project was renamed to _Jujutsu_ — in
part because it meant we could keep the command name `jj`.

Jujutsu is a Japanese word that has two distinct interpretations in English,
each with their own kanji and romanized form:

- 柔術 _Jūjutsu_ — a family of Japanese martial arts, commonly spelled as
"**jujitsu**" or "**jiu-jitsu**" in the West. Thankfully, we checked the
spelling first.

- 呪術 _Jujutsu_ — roughly meaning "magic" or "sorcery".

However, the basic english word "jujutsu" on its own is somewhat ambiguous to
native Japanese speakers, because most English words don't use the long vowel
form "ū", making it unclear what the intended meaning might be when an English
speaker writes it.

For some time, we left the interpretation ambiguous.

However, we have officially chosen **second** interpretation as the official
name of the tool, 呪術 _Jujutsu_ as in "sorcery". Many of our users have said
that as a version control system, Jujutsu simply feels like magic to them, so we
think this is a fitting interpretation.

The name "Jujutsu" is also known by many of our users through the popular manga
and anime series _Jujutsu Kaisen_ (呪術廻戦). We didn't choose the name because
of the series, but we're happy so many people enjoy the connection.

### What's the proper way to refer to the project and tool?

If you are writing a technical document, blog, article, forum post, social media
endorsement, then the proper name of the project is Jujutsu (呪術 _Jujutsu_) and
should be referred to as such in the text. Use it like any other proper noun.
You don't _need_ to specify the kanji and romanized form, though it would be
courteous to your Japanese-native readers to do so for the reasons explained
above.

In contrast, the name `jj` only refers to the command line interface of the
tool, or generally the codebase of the tool itself. When writing about the
command line interface, please refer to it as `jj` with the proper typographic
code formatting, etc. (Occasionally though, the developers and contributors
themselves may refer to the project as `jj` in casual conversations around the
watercooler.)

[branches_conflicts]: branches.md#conflicts

[change ID]: glossary.md#change-id
Expand Down