From b66adb4bb78c0199fe0683c2474b1fc271bf7a75 Mon Sep 17 00:00:00 2001 From: Austin Seipp Date: Sat, 7 Oct 2023 16:13:45 -0500 Subject: [PATCH] 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 Change-Id: I18ec68722362a2a64b99a368d3f25cf5 --- README.md | 81 ++++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 63 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 01a3e5430..45e2fb516 100644 --- a/README.md +++ b/README.md @@ -1,23 +1,25 @@ -# Jujutsu VCS +
-![](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)
-![](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 ) 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). +
## 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, ) 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.