alt Hacker NewsI tried to understand what this does...
> What is Radicle? How is it different from Git/GitHub?
> Radicle is a peer-to-peer code collaboration platform (“forge”) built on Git. Unlike centralized platforms like GitHub, there is no single entity controlling the network or user data. Repositories are replicated across peers in a decentralized manner. Radicle is an alternative for people and organizations who want full control of their data and user experience, without compromising on the social aspects of collaboration platforms.
(Quote from their FAQ).
This isn't even trying to answer the titular question... None of them, actually.
So, what is Radicle? A platform built on Git? What does this mean? A platform for what? What is it for?
Why Git/GitHub are used as if they were the same category of things? There's not even an attempt at answering the "how is this different from Git?" question. What does it offer that Git doesn't? Wtf is "forge"?
Radicle is an alternative... to what? I believe I have full control of my data in my Git repository... why do I need an alternative with even more control? How will I have even more control?
* * *
Maybe whatever this software does is actually useful or even good, but the documentation can't be worse.
Replies
> So, what is Radicle?
> Radicle is a peer-to-peer code collaboration platform (“forge”) built on Git.
-----
> Why Git/GitHub are used as if they were the same category of things?
They are not. Github is a centralized collaboration platform built on git, and radicle is a peer-to-peer collaboration platform built on git.
-----
> Wtf is "forge"?
A word some people started using for the class of Github/Bitbucket(RIP) or even Fossil-type things, as FOSS alternatives began to multiply.
-----
> Radicle is an alternative... to what?
To Github, or other "forges."
I agree it's not immediately clear how it works, although I think I understand the role it's intending to fill.
If you're not familiar with the distinction between git and github it could be even more confusing.
As soon as I hear decentralized I have lots of questions about the underlying protocols. Their protocol page helps a little but also uses terms I'm not familiar with like "gossip protocol".
It would be nice for there to be a page that motivates the project a bit more, ie. explaining the technical problems they are attempting to solve before enumerating the components of the complex system they've built.