mirror of
https://github.com/martinvonz/jj.git
synced 2024-09-11 05:45:30 +03:00
readme: tidy up the front matter a little
Summary: Reintroduce 4acdf726
without spurious formatted changes. (This means I
don't have to go back over things with a fine comb.)
Signed-off-by: Austin Seipp <aseipp@pobox.com>
Change-Id: I18ec68722362a2a64b99a368d3f25cf5
This commit is contained in:
parent
706c5026f6
commit
b66adb4bb7
81
README.md
81
README.md
@ -1,23 +1,25 @@
|
||||
# Jujutsu VCS
|
||||
<div class="title-block" style="text-align: center;" align="center">
|
||||
|
||||
![](https://img.shields.io/github/license/martinvonz/jj) ![](https://img.shields.io/github/v/release/martinvonz/jj) ![](https://img.shields.io/github/release-date/martinvonz/jj) ![](https://img.shields.io/crates/v/jj-cli)
|
||||
# Jujutsu—a version control system
|
||||
|
||||
![](https://img.shields.io/github/license/martinvonz/jj)
|
||||
![](https://img.shields.io/github/v/release/martinvonz/jj)
|
||||
![](https://img.shields.io/github/release-date/martinvonz/jj)
|
||||
![](https://img.shields.io/crates/v/jj-cli)
|
||||
<br/>
|
||||
![](https://github.com/martinvonz/jj/workflows/build/badge.svg) ![](https://img.shields.io/codefactor/grade/github/martinvonz/jj/main) ![](https://img.shields.io/librariesio/github/martinvonz/jj)
|
||||
![](https://github.com/martinvonz/jj/workflows/build/badge.svg)
|
||||
![](https://img.shields.io/codefactor/grade/github/martinvonz/jj/main)
|
||||
![](https://img.shields.io/librariesio/github/martinvonz/jj)
|
||||
|
||||
- [Disclaimer](#disclaimer)
|
||||
- [Introduction](#introduction)
|
||||
- [Getting started](#getting-started)
|
||||
- [Status](#status)
|
||||
- [Related work](#related-work)
|
||||
**[Homepage] • **
|
||||
**[Installation] • **
|
||||
**[Getting Started Tutorial]**
|
||||
|
||||
## Disclaimer
|
||||
[Homepage]: https://martinvonz.github.io/jj
|
||||
[Installation]: https://martinvonz.github.io/jj/latest/install-and-setup
|
||||
[Getting Started Tutorial]: https://martinvonz.github.io/jj/latest/tutorial
|
||||
|
||||
This is not a Google product. It is an experimental version-control system
|
||||
(VCS). I (Martin von Zweigbergk <martinvonz@google.com>) started it as a hobby
|
||||
project in late 2019. That said, this is now my full-time project at Google. My
|
||||
presentation from Git Merge 2022 has information about Google's plans. See the
|
||||
[slides](https://docs.google.com/presentation/d/1F8j9_UOOSGUN9MvHxPZX_L4bQ9NMcYOp1isn17kTC_M/view)
|
||||
or the [recording](https://www.youtube.com/watch?v=bx_LGilOuE4).
|
||||
</div>
|
||||
|
||||
## Introduction
|
||||
|
||||
@ -41,9 +43,24 @@ 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".
|
||||
|
||||
If you have any questions, please join us on Discord
|
||||
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
|
||||
[![Discord](https://img.shields.io/discord/968932220549103686.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/dkmfj3aGQN)
|
||||
or start a [GitHub Discussion](https://github.com/martinvonz/jj/discussions).
|
||||
or start a [GitHub Discussion](https://github.com/martinvonz/jj/discussions); the
|
||||
developers monitor both channels.
|
||||
|
||||
> [!IMPORTANT]
|
||||
> Jujutsu is an **experimental version control system**. While Git compatibility
|
||||
> is stable, and most developers use it daily for all their needs, there may
|
||||
> still be work-in-progress features, suboptimal UX, and workflow gaps that make
|
||||
> it unusable for your particular use.
|
||||
|
||||
### News and Updates 📣
|
||||
|
||||
- **Jan 2023**: Martin gave a presentation about Google's plans for Jujutsu at
|
||||
Git Merge 2022! See the
|
||||
[slides](https://docs.google.com/presentation/d/1F8j9_UOOSGUN9MvHxPZX_L4bQ9NMcYOp1isn17kTC_M/view)
|
||||
or the [recording](https://www.youtube.com/watch?v=bx_LGilOuE4).
|
||||
|
||||
## Getting started
|
||||
|
||||
@ -68,7 +85,6 @@ version](https://martinvonz.github.io/jj/prerelease/). You can also get there
|
||||
from the docs for the latest release by using the website's version switcher. The version switcher is visible in
|
||||
the header of the website when you scroll to the top of any page.
|
||||
|
||||
|
||||
## Features
|
||||
|
||||
### Compatible with Git
|
||||
@ -180,3 +196,32 @@ scripts if requested.
|
||||
|
||||
There are several tools trying to solve similar problems as Jujutsu. See
|
||||
[related work](https://martinvonz.github.io/jj/latest/related-work) for details.
|
||||
|
||||
## Contributing
|
||||
|
||||
We welcome outside contributions, and there's plenty of things to do, so
|
||||
don't be shy. Please ask if you want a pointer on something you can help with,
|
||||
and hopefully we can all figure something out.
|
||||
|
||||
We do have [a few policies and
|
||||
suggestions](https://martinvonz.github.io/jj/prerelease/contributing/)
|
||||
for contributors. The broad TL;DR:
|
||||
|
||||
- Bug reports are very welcome!
|
||||
- Every commit that lands in the `main` branch is code reviewed.
|
||||
- Please behave yourself, and obey the Community Guidelines.
|
||||
- There **is** a mandatory CLA you must agree to. Importantly, it **does not**
|
||||
transfer copyright ownership to Google or anyone else; it simply gives us the
|
||||
right to safely redistribute and use your changes.
|
||||
|
||||
### Mandatory Google Disclaimer
|
||||
|
||||
I (Martin von Zweigbergk, <martinvonz@google.com>) started Jujutsu as a hobby
|
||||
project in late 2019, and it has evolved into my full-time project at Google,
|
||||
with several other Googlers (now) assisting development in various capacities.
|
||||
That said, **this is not a Google product**.
|
||||
|
||||
## License
|
||||
|
||||
Jujutsu is available as Open Source Software, under the Apache 2.0 license. See
|
||||
[LICENSE](./LICENSE) for details about copyright and redistribution.
|
||||
|
Loading…
Reference in New Issue
Block a user