Flesh out `README`

This commit is contained in:
Alexis Sellier 2023-03-12 16:30:20 +01:00 committed by Alexis Sellier
parent 646376828d
commit 49a6dacd75
No known key found for this signature in database
2 changed files with 41 additions and 9 deletions

3
HACKING.md Normal file
View File

@ -0,0 +1,3 @@
# HACKING
*Work in progress.*

View File

@ -2,17 +2,46 @@
*Radicle Heartwood Protocol & Stack* *Radicle Heartwood Protocol & Stack*
Heartwood is in the early development phase and is not yet ready for use. Heartwood is the third iteration of the Radicle Protocol, a powerful
peer-to-peer code collaboration and publishing stack. The repository contains a
full implemention of Heartwood, complete with a user-friendly command-line
interface (`rad`) and network daemon (`radicle-node`).
Radicle was designed to be a secure, decentralized and powerful alternative to
code forges such as GitHub and GitLab that preserves user sovereignty
and freedom.
## Installation ## Installation
``` **Requirements**
# Command line tools
$ cargo install --locked --path ./radicle-cli
# The radicle node * *Linux* or *Unix* based operating system.
$ cargo install --locked --path ./radicle-node * Git 2.34 or later
* OpenSSH 9.1 or later with `ssh-agent`
# Git tool to support the 'rad://' remote scheme ### 📦 From source
$ cargo install --locked --path ./radicle-remote-helper
``` > Requires the Rust toolchain.
You can install the Radicle stack from source, by running the following
commands from inside this repository:
cargo install --path radicle-cli --force --locked
cargo install --path radicle-node --force --locked
cargo install --path radicle-remote-helper --force --locked
Or directly from our seed node:
cargo install --force --locked --git https://seed.radicle.xyz/z3gqcJUoA1n9HaHKufZs5FCSGazv5.git \
radicle-cli radicle-node radicle-remote-helper
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) and [HACKING.md](HACKING.md) for an
introduction to contributing to Radicle.
## License
Radicle is distributed under the terms of both the MIT license and the Apache License (Version 2.0).
See [LICENSE-APACHE](LICENSE-APACHE) and [LICENSE-MIT](LICENSE-MIT) for details.