Hacker News new | ask | show | jobs
by mbrock 4316 days ago
I wish projects like these would always include some basic info in their README about: (1) how it works, and (2) how it might fail.
5 comments

Seconded. The extent of what I know about this project is:

1. It's like git somehow?

2. I can run some commands which presumably do something?

3. That something happens faster than something postgres can do, which I assume accomplishes the same thing?

4. I assume there's nothing else I need to know?

That's the first thing I looked for too. Anyway, I opened an issue: https://github.com/fastmonkeys/stellar/issues/13
Totally agree, peoples needs to know how it works before starting using it.
From what little I've gathered, the internal implementation is basically a system which tracks hash-tagged copies of database tables.
There are only like 700 lines of Python code. Figure it out and submit a pull request to update the README.
So it's yet another toy project with grandiose, overblown claims ("git for databases"? seriously?!)

An honest update to the README would be to take the whole thing down several notches, if nothing else then to avoid the kind of confusion the post you're replying to expresses.

I really don't think we have to get so worked up about that kind of thing. If you don't like it, just ignore it.